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PREFACE 



XEDIT is an extended interactive text editor developed by 
the University of Minnesota and available for use on the 
CDC® Network Operating System (NOS). NOS provides 
network capabilities for time-sharing and transaction 
processing, in addition to local and remote batch 
processing, on the CDC® CYBER 170 Series computer 
systems, CDC® CYBER 70 Series, models 71, 72, 73, and 74 
computer system, and 6000 Series computer systems. 

This manual describes XEDIT use. Each section explains 
and demonstrates a number of similar XEDIT commands. 



AUDIENCE 

This manual assumes that the user is familiar with NOS 
operation and file concepts. For information on 
time-sharing processing, the user should refer to the IAF 
Version 1 Reference Manual or the NOS Version 1 
Time-Sharing User's Reference Manual. For batch 
processing information, the user should refer to the NOS 1 
Batch User's Guide and NOS 1 Reference Manual, volume 1. 



Publication 

Control Data Publication Number 

NOS Manual Abstracts 84000420 

NOS Version 1 Batch User's Guide 60436300 

NOS Version 1 Diagnostic Index 60455720 

NOS Version 1 Reference Manual, 

Volume 1 60435400 

NOS Version 1 Terminal User's 

Instant 60435800 

NOS Version 1 Time-Sharing User's 

Guide 60436400 

NOS Version 1 Time-Sharing User's 

Reference Manual 60435500 

Text Editor Reference Manual 60436100 



RELATED PUBLICATIONS 

The following manuals may be of interest to the XEDIT 
user. 



Control Data Publication 

Network Products 
Interactive Facility Version 1 
Reference Manual 

Network Products 
Interactive Facility Version 1 
User's Guide 

Network Products 

Network Terminal User's Instant 



Publication 
Number 



60455250 



60455260 



60455270 



CONVENTIONS 

In the examples in this manual, user input is printed in 
lowercase lettters, and XEDIT output is printed in 
uppercase letters. 

The symbol @ in this manual is used to denote the 
terminal key that must be pressed in order to send an input 
line to the system. For most time-sharing terminals, this is 
the carriage return key. IAF users should refer to the IAF 
Reference Manual to determine which key applies to them. 



DISCLAIMER 

This product is intended for use only as described in this 
document. Control Data Corporation cannot be responsible 
for the proper functioning of undescribed features or 
undefined parameters. 
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INTRODUCTION 



XEDIT can be used to manipulate the following types of 
files: 

• Primary files. 

• Local files. 

• Indirect access files. 

• Direct access files. 

These files can have one or more of the following 
characteristics: 

• Multifile and/or multirecord files (that is, files 
containing more than one end-of-file or 
end-of-reeord mark). 

• Files containing either source programs, data, or 
text (listable files). 

• Files prepared in either normal or ASCII mode. 
The user should not use XEDIT to edit binary files. 



XEDIT FEATURES 

The following are features of XEDIT: 



Simple command formats. 

Multiple commands in a single line. 

Verification of user entries; XEDIT automatically 
lists the file lines modified by a command. 

Internal interrupt processing; control is not 
returned to the operating system. . 

Editing on the basis of line numbers. 

Availability of permanent file commands; a file can 
be stored without leaving XEDFT. 

Easy line modification; strings may be edited on a 
character-by-character basis. 

Editing multifile and/or multirecord files. 

Tab control capability. 

Window capability; the scope of all string search 
commands may be restricted to a specific set of 
columns. 

• Available for batch processing. 

Appendix C contains sample editing sessions using these 
XEDIT features. 
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CALLING XEDIT 



This section describes the methods of calling XEDIT in 
time-sharing and batch jobs. XEDIT parameters are 
explained and frequently used versions of the XEDIT 
command are shown. 

The user can call XEDIT from a time-sharing terminal by 
using the XEDIT command, where editing commands can be 
given interactively, t In a batch job the XEDIT, control 
statement calls XEDIT, where a set of editing directives is 
processed without further user direction. Although XEDIT 
makes certain changes in its processing depending on 
whether a job is of time-sharing origin or of batch origin, 
the format for calling XEDIT is the same. 



INITIATING XEDIT 

The user initiates XEDIT by using the format 

XEDIT,lfn 1 ,p 1 ,P2,..-,P TV dcs 

The file name lfni must be the first parameter listed, and 
the trailing delimited command sequence (dcs) must come 
after the period. All other parameters are 
order-independent. A brief description of the XEDIT 
parameters follows: 

lfni Name of the local or permanent file to be 

edited (default is primary file). 

pj One or more of the following optional 

parameters: 

AS Process the file in ASCII mode. 

B XEDIT assumes the job is of batch 

origin. 

C Create new file lfn^. 

FR Take first editing command from 

first line of file lfn x . If FR and I 
are both specified, XEDIT 
executes FR and then I. 

I=lfn2 Take editing commands from file 

lfri2- If I =0 > commands are taken 
from dcs field. If I is omitted, 
file INPUT is assumed. 

L=lfn3 Place XEDIT output on file If 113. 

If L=0, no output is generated. If 

Li IS OnULLC'U, me uuii vi i" 

assumed. 

NH Suppress printing of the XEDIT 

header. 

P Retrieve and edit permanent file 

lfni. 



dcs Delimited command sequence that is processed 

before XEDIT takes commands from file 
INPUT or file lfn 2 . 

The following information describes the effects of 
specifying or omitting a parameter and examples of how it 
could be used. 



Parameter 



AS 



lfni 



Description 

XEDIT processes the edit file in 
ASCII mode. Upon exiting XEDIT, 
the terminal is returned to the mode 
in effect before the editing session. 
If the user omits the AS parameter, 
the mode that the terminal is in 
before he enters the XEDIT 
command remains in effect. 
Example of use: 

To call XEDIT to edit the file NEWS 
in ASCII mode: 

XEDIT, NEWS, AS 

If specified, the local or permanent 
file name is rewound, sorted if it is 
a sequenced primary file, edited as 
directed, and rewound after 
processing. 

If omitted, the primary file is 
edited. If there is no primary file, 
the system prints 

EMPTY FILE/CREATION 
MODE ASSUMED 

and execution begins under creation 
mode (refer to explanation of the C 
parameter). If the file name is 
omitted, the separators that would 
appear before and after the file 
name must be included before other 
parameters are specified. 

Example of use: To caU XEDIT to 
edit a local file called ADDRESS: 

XEDIT.ADDRESS 

If specified, file lfni is retrieved 
from the user's permanent file 
catalog as a local file. Direct 
access° files are attached in write 
mode. If the file lfni is not found in 
the user's permanent file catalog, 
XEDIT prints an informative 



t Users of certain terminals should issue a ROUT command, or if using IAF, a terminal definition command, before calling 
XEDIT, since their terminal carriage return must operate at the correct speed if proper character alignment is to be made. 
This is necessary for successful execution of the MODIFY, QMOD, and YQMOD commands. Refer to the Time-Sharing 
User's Reference Manual for a description of the ROUT command and to the IAF Reference Manual for a description 01 the 
terminal definition command. 
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Parameter 



dcs 



Description 

message and requests the name of 
the file to be edited. The user 
should then enter the file name 
followed by a C or P parameter, if 
appropriate. 

If omitted, the file lfnj is assumed 
to be a local file. 

Example of use: To call XEDIT to 
edit a permanent file called ADDR: 

XEDIT, ADDR.P 

If specified, XEDIT begins execution 
in creation mode. In creation mode, 
only the following commands are 
valid. 



Parameter 



55 


INSERT 


TEOR 


BRIEF 


LIST A B 


TOPNULL 


DEFTAB 


NOBELLS 


TRIM 


DELIMIT 


RMARGIN 


VERIFY 


EXPLAIN 


STOP 


WHERE 


HELP 


TABS 


Y 


INPUT 


TJiUF 


Z 



XEDIT leaves creation mode when a 
line of text exists within the file. 
Normal editing can follow. Upon 
exit, a local file is generated with 
the name, lfn 1( specified in the 
XEDIT command. If a file name 
lfnj is not specified, the file takes 
the name of the primary file, or if 
there is no primary file, TAPE1. 

If omitted, the file to be edited 
must contain at least one line of 
text; otherwise, the system prints 

EMPTY FILE/CREATION MODE ASSUMED 

Example of use: To create a file 
called ADDR: 

XEDIT,ADDR,C 

One or more commands entered at 
the end of the XEDIT statement. If 
specified, XEDIT takes its editing 
commands from the dcs before 
taking commands from the input 
file. Its format is the same as that 
of a multiple command interactive 
entry (refer to section 10) except 
the delimiter character is assumed 
to be a semicolon unless specified 
otherwise by the first character of 
the sequence. The characters which 
can begin XEDIT commands (letters, 
numbers, +, /, f) and the characters 
-, *, comma, and space are not 
recognized as command delimiters. 

If omitted, XEDIT takes its 
commands from the first line of the 



I=lfn 9 or 1=0 



FR 



Description 

file to be edited, if the FR 
parameter is specified. XEDIT 
takes its commands from the default 
or specified input file, if 1=0 is not 
specified. 

Example: This command causes 
XEDIT to print out the file ADDR 
before processing the editing 
commands from the input file 8: 

XEDIT, ADDR, I=B. PRINT* 

If I=lfn 2 is specified, XEDIT takes 
its editing commands from the 
specified file after processing 
commands from the first line of the 
file to be edited (if the FR 
parameter is specified) and/or a 
trailing delimited command 

sequence. The last command in the 
specified command file must be 
END, QUIT, or STOP; otherwise, 
XEDIT aborts. 

If 1=0 is specified, XEDIT takes its 
editing commands from the first line 
of the file to be edited (if the FR 
parameter is specified) and from a 
trailing delimited command 

sequence. The last command in the 
delimited command sequence (dcs) 
must be END, QUIT, or STOP; 
otherwise, XEDIT aborts. 

If I is omitted, XEDIT takes editing 
commands for a batch job from the 
next record of the job deck. For a 
time-sharing job, XEDIT takes 
commands from terminal input or 
the file INPUT. 

Examples of use: To call XEDIT to 
edit a local file called ADDR with 
commands from a previously created 
file called INFILE: 

XEDIT,ADDR,I=INFILE 

To call XEDIT to edit a local file 
called ADDR using only commands 
from the trailing dcs: 

XEDIT,ADDR,I=O.PRINT*;END,ADDR,RL 



If specified, XEDIT takes its first 
editing command from the first line 
of the file to be edited. The 
command is assumed to begin with 
the first nonblank character 
following two consecutive blanks. 
XEDIT then takes its commands 
from the dcs, if one is specified, and 
then from the input file. 

If omitted, XEDIT takes its editing 
commands from the dcs, if one is 
specified, and then from the input 
file. 



2- 1 ? 



60455730 B 



Parameter 



NH 



L=lfn 3 or L=0 



Description 

Example of use: To call XEDIT to 
edit a file called ADDR, and to take 
its first command from the first line 
of ADDR: 

XEDIT.ADDR.FR 

The following examples show 
possible first lines in the file to be 
edited which would set the delimiter 
character, tab character, and tab 
settings. 

COMPASS: * Y/DELIMIT;/ 

DEFTABS/ 

TABS 10 20 30 
FORTRAN: 00100C Y/DELIMIT;/ 

DEFTAB$/ 

TABS 10 20 30 
MODIFY: */ Y/DELIMIT;/ 

DEFTAB$/ 

TABS 10 20 30 
BASIC: 00100 REM Y/ 

DELIMIT;/DEFTAB$/ 

TftBS-te-20 30 

If specified, the XEDIT header 
message (for example, XEDIT 
3.1.00) is not printed. 

If omitted, the header message is 
printed to verify entry into XEDIT. 

Example of use: To call XEDIT to 
edit the primary file without 
printing the header message: 

XEDIT„NH 

If L=lfn 3 is specified, all XEDIT 
output goes on the specified file. 
The file is not rewound before or 
after processing. If lfn 3 is to be 
printed on a batch line printer, the 
file .should be .shifted by one 
character position to avoid printer 
carriage control characters. Refer 
to the COPYSBF control statement 
in the NOS Reference Manual, 
Volume 1. 

If L=0 is specified, XEDIT generates 
no output. 

If omitted, all XEDIT output goes on 
the default file OUTPUT. 

To caU XEDIT to edit the file ADDR 
and leave its output on file 
OUTFILE:. 

XEDIT,ADDR,L=OUTFILE 

To call XEDIT to edit the file ADDR 
without producing any output: 

XEDIT, ADDR,L=0 

If specified, XEDIT processes the 
job as a batch origin job regardless 
of its method of entry. Any error in 
the editing commands causes XEDIT 
to abort. 



Parameter Description 

If omitted, jobs are processed 
n /.nnn^irfT t<-> their nricn'n. Jobs run 
under the batch subsystem are ol 
time-sharing origin; jobs entered 
from a card reader or via the 
SUBMIT or ROUTE control 
statements are of batch origin. 

Example of use: To call XEDIT to 
edit file ADDR if the commands 
taken from the input file INFILE are 
correct. If any error exists within 
the commands, XEDIT aborts, and 
file ADDR remains in its unedited 
form. 

XEDIT,ADDR,I=INFILE,B 



INTERACTIVE USAGE OF XEDIT 

The time-sharing user frequently uses the default values 
when entering the XEDIT command. Entering 

XEDIT 

calls the XEDIT program and edits the primary file in 
response to commands entered at the terminal. Output is 
printed at the terminal using the existing character set 
mode. 

After the XEDIT command is entered, the system replies: 

XEDIT 3.1.00 
?? 

This message indicates that the XEDIT program is initiated 
and awaiting commands. Only XEDIT commands are 
processed; time-sharing commands are illegal until the user 
exits XEDIT. 

XEDIT can be called from any of the time-sharing 
subsystems. 



BATCH USAGE OF XEDIT 

XEDIT can be used by a batch job if the job includes the 
XEDIT control statement in its control statement record. 
A basic form of the XEDIT control statement omits the I, 
L and FR parameters. XEDIT then takes its editing 
directives from a job deck record following the control 
statement record and leaves its output on file OUTPUT. 
The final command in the editing directives must be END 
or QUIT; otherwise, XEDIT aborts. 



NOTE 



If the NEW or OLD control statements are 
used to create or retrieve the file to be 
edited, the /ND parameter must be 
specified on the NEW or OLD control 
statement so that XEDIT can take its 
directives from a later record in the job 
deck. (The NEW and OLD statements 
return all files including file INPUT if 
/ND is omitted.) 



Figure 2-1 is an example of a batch job that uses 
XEDIT. 
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JOBMAME. ® 

u'SER(KS59 , 3^56 , FAM1 ) 

CHAHGE(4812,HGG33^5) 

GET(BATCHFL) 

XEDIT(BATCHFL) 

REPLACE(BATCHFL) 

7/8/9 

p*© 

C/BOX/P.O. BOX/25 

f D» 

END 
6/7/8/9 



(T) The user names the job. He provides user identification and 
validation information. He accesses an indirect access file called 
BATCHFL. He calls XEDIT to edit the file BATCHFL. He replaces 
the edited file. 



© 



The second record of the job deck contains the editing directives to 
be used. 



Figure 2-1. Batch Job Using XEDIT 
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XEDIT CONVENTIONS 



All XEDIT commands have the same basic format as 
explained in General Rules for XEDIT Input. This section 
also explains how XEDIT provides the means to suppress 
default conditions, interrupt XEDIT processing without 
leaving XEDIT, and obtain explanations of commands and 
error messages during the editing session. 



GENERAL RULES FOR XEDST SNPUT 

All XEDIT commands follow the same basic pattern in their 
syntax and parameters and in their required editing data. 
Knowledge of this basic pattern leads to fewer user errors 
while editing. 



XEDIT COMMAND SYNTAX 

XEDIT prints a double question mark (?'?) whenever it 
expects the user to enter an XEDIT command.! The syntax 
for an XEDIT command is: 

pre f i xlnco m m and 

The optional prefix characters are: 

Prefix Description 

/ Advances the pointer one line before 

processing the command. 

A or f Repositions the pointer to the beginning 

of the file before processing the prefixed 
command. This character is octal 76. 

X Temporarily suppresses VERIFY or BRIEF 

mode while processing the prefixed 
command. 

+ Informs XEDIT that editing data exists on 

the same line as the command itself when 
used in conjunction with the DELIMIT, Y, 
or Z commands; the ADD, INSERT, 
INSERTB, MODIFY, QMOD, REPLACE, 
and YQMOD commands are the only 
commands that use the + prefix. It is 
ignored when used with other commands. 
(Refer to section 10.) 

Prefix characters can be used in any order and combination 
•and on any legal XEDIT command. 

An optional line number prefix (In) specifies the line 
number that begins the line at which the prefixed command 
is to begin processing. If the specified line is not found, 
the command is not processed, an informative message is 
printed, and if editing in verify mode, the line at the 
current pointer position is also printed. 



A legal command conforms to the following conventions. 

• The command must be spelled correctly. 

• Command parameters must follow the sequence 
shown in that command's description. 

• Command parameters must stay within their 
maximum and minimum numerical limits. When an 
asterisk is substituted for an n or m parameter, it 
has a value of 99999. 

• The command must be entered at the position 
where the terminal print element stopped after 
printing the double question mark. 

• No embedded blanks can appear within a command 
or between a line number prefix and a command. 

• The command must be separated from its 
parameters by either a comma, a space, or for 
string parameters, the string delimiter. 

• Extra spaces may appear between command 
parameters. 

• XEDIT initiates its search for a given line or string 
at the pointer position. 

If the user does not enter a valid command after a double 
question mark prompt (??), XEDIT prints an error message 
and another double question mark prompt (??). 



XEDIT COMMAND PARAMETERS 

In this manual, most XEDIT command formats use the 
following symbols: 

Symbol Description 

n Number of file lines that the command 

should process. This number should be a 
positive integer less than 100000. Its 
default value is 1. If n is *, XEDIT 
processes every line from the pointer 
position to the end-of-information (XEDIT 
prints an END OF FILE message) or until 
it is processed 99999 times. 

m Same as n except it specifies the number 

of occurrences of a string, an end-of-file 
mark or an end-of-record mark. 

In Line number that begins the line to be 

edited. It must be a positive integer less 
than 100000. 



t A double question mark is not printed if the user has assigned the input or output file to a mass storage device or to a file 
via the XEDIT command parameters I=lfn or 1=0. 
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ENTERING EDITING DATA 



XEDIT commands often require that the user enter data 
indicating how the file should be modified. When editing 
data is needed, XEDIT prints a single question mark prompt 
(?). Editing data is requested for ADD, MODIFY, QMOD, 
YQMOD, INPUT, REPLACE, and INSERT commands. 

Figure 3-1 shows entry of editing data for a MODIFY 
command. 

If the user enters a carriage return after the single 
question mark (?), XEDIT prints a double question mark (??) 
indicating that the command was not processed and that 
the user can enter his next editing comand. 

Editing data can also be entered in the same line as the 
command by using a + prefixed command in a Y or Z 
command list or by entering a + prefixed command in a 
delimited command sequence (refer to Submitting Multiple 
Entries in a Single Line in section 10). 



NOTE 



In IAF the user should not use the cancel 
line character as the last character of a 
line unless he wishes to cancel the line. 



STRING DELIMITERS 

Certain XEDIT commands allow the user to replace 
sequences of numbers or characters (strings) that appear 
within a file line. When a user enters a string command, he 
separates the string from the command itself, other 
parameters, and other strings by using a string delimiter. 
A string delimiter can be any character that is not part of 
the string. The character must be within the NOS 
time-sharing character set (refer to the character set 
tables in the NOS Reference Manual, Volume 1) and cannot 
be a space, number, asterisk, or comma. If the delimiter is 
alphabetic, a space must separate the command and the 
delimiter. In this manual, delimiters are represented by a 
slash (/) character. 



For example, if a user wants to locate the next line 
containing the string IF N =, any of the following LOCATE 
commands are legal and will accomplish this purpose. 

LOCATE/IF N = / @ 
LOCATE"IF N = " @ 
LOCATE ZIF N = Z@ 



SUPPRESSING DEFAULT CONDITIONS 

The XEDIT user may find that he does not want certain 
aids provided by XEDIT. Therefore, XEDIT has commands 
to suppress verification, terminal bell ringing, and the 
printing of file and record marks. 



SUPPRESSING VERIFICATION 

By default, XEDIT assumes that the user wants verification 
of the effect of an XEDIT command on his file. For 
example, suppose a user wants to delete two lines in the 
file, beginning at the current file pointer position. To do 
this, the user would issue a DELETE command. XEDIT 
automatically lists the lines which are deleted so that the 
user can verify that the command performed the task 
which was intended. This automatic verification occurs in 
verify mode. 

While verify mode is the default condition for XEDIT, the 
user can suppress verification if he wants and edit under 
brief mode. The user can select verification or no 
verification by entering one of the following commands. 

Action Legal Commands 

Verification VERIFY @ 

VERIFY+@ 
BRIEF- @ 

W@ 

No Verification BRIEF <g) 

BRIEF+ @ 
VERIFY-^ 
BR@ w 

Figure 3-2 illustrates the difference between verify mode 
and brief mode. In both instances, the user issues a 
DELETE command to delete the next three lines in the file. 



?? 1 10modify © ® XEDIT sends a double question mark; user responds by issuing 

00110 1544 WILSHIRE ST' ZI? 55722© ^ a MODIFY command to alter line 110. 

? 20 X XEDIT prints line 110. 

00110 1244 WILSHIRE ST ZI? 55722© © XEDIT prints a single question mark; user supplies editine 

°° data. 5 



XEDIT prints the modified version of line 110. 



Figure 3-1. Entry of Editing Data 



Verify Mode 






?? delete 3 
00110 1244 
00170 POB 5 
00200 8710 

99 


4ILSHIRE 
5*55703 

14TH ST I 


ST 
5571 


55722 
3 



Brief Mode 



?? brief 



UC1CUC J 



Figure 3-2. Verify Versus Brief Mode 
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When editing under either verify or brief mode, a user may 
want to process a single command under the alternate 
mode without having to issue a BRIEF or VERIFY 
command. This can be done by prefixing the command with 
an x, as shown in figure 3-3. 



SUPPRESSING PRINTING OF FILE MARKS 

XEDIT prints the messages -EOR- and -EOF- when it 
reads an end-of-record mark or end-of-file mark while 
processing a command. A user may turn off and turn on 
the printing of these file marks by choosing one of the 
following commands. 



Format 

TEOF+@ 
TEOF- @ 
TEOF @ 
TEOR+® 
TEOR- @ 
TEOR @ 



Action 

Turns on the printing of —EOF— messages 
Turns off the printing of -EOF- messages 
Toggles printing of —EOF- messages 
Turns on the printing of -EOR— messages 
Turns off the printing of —EOR— messages 
Toggles printing of —EOR— messages 



Figure 3-4 shows suppression of the printing of file marks. 



SUPPRESSfNG TERMINAL BELL RINGING 

The NOBELLS command allows the user to suppress bell 
ringing when XEDIT messages are printed. Its formats are: 

NOBELLS @ 

NB @ 

Figure 3-5 tests this command. 



INTERRUPTING XEDIT PROCESSING 

The user can interrupt XEDIT processing without 
terminating XEDIT execution. To stop the printing of 
XEDIT output on non-IAF terminals, the user presses the 
BREAK key (or its equivalent). On IAF terminals the user 
presses the BREAK key (or its equivalent) and the 
interruption or .termination sequence. XEDIT prints a 
double question mark to request entry of the next editing 
command. 

If the interruption occurs while a Z, Y, or delimited 
command sequence is being processed, the remaining 
component commands in the command list are skipped. 

To stop XEDIT requests for editing data (single question 
mark prompts), the user presses the carriage return. 



?? verify© 

?? *locate/zip/(2) _ 

00110 1544 WILSHIRE ST ZIP CODE 55722(3) 
?? xchange/zip code/zip/ 



The user issues a VERIFY command. 

The user issues a LOCATE command. 

XEDIT prints the located line. 

The user. issues a CHANGE command with an x 

prefix; XEDIT suppresses its verification. 



Figure 3-3. Suppressing Verification 



?? print* ® 
♦EXECUTIVE MANAGEMENT* 



Q The user lists a file containing end-of-record and end-of-file 
marks. 



KRAMER 
THOMPSON 



— EOR— 
:00100 A.B 
00110 J.J 
— EOR— 
— EOF— 

00120 B.C. MILLER 
END OF FILE 
?? teor © 
?? teof 
?? print* 
♦EXECUTIVE 
00100 A.B. 
00110 J.J. 
00120 B.C. 
END OF FILE 

-79 



MANAGEMENT* 

KRAMER 

THOMPSON 

MILLER 



HOR2 4 
SWP19 



HQR44 



HQR2 4 
SWP 1 9 
HQR44 



(2) A TEOR command and a TEOF command are issued to 
suppress the printing of the —EOR— and —EOF— messages. 
The file is listed again. 



Figure 3-4. Suppressing Printing of File Marks 



?? nobells® 
?? print/® 

ILLEGAL PARAMETER 
?? end 



2) The user issues a NOBELLS command. 

jl) He then issues a PRINT command with an illegal parameter 
to test if the bell rings when the error message is printed. 



Fi<mre 3-5. Suppressing Terminal Bell Ringing 



60455730 B 



3-3 



ON-LINE REFERENCE AIDS 

The USer O.an iSSUP A HPTP <">nmmon<H fr>n a .--loc^r.;^,™ „f „ 

CmtimanH np an TTVDI ATM ^. r^^„«^ P-,„ ,-,„ -,v— ' - -. - ■■- - - ,- <• 
~- iai.v- -» ^.. ""» ■Jiuii t-Oiiiiuciiivj iui an eXpiaflailOtl OI 

an XEDIT message. 



ASKING FOR ERROR MESSAGE EXPLANATIONS 

The EXPLAIN command lets a user request an explanation 
of an error message that has just been printed. The 
messages explained by the EXPLAIN command are listed in 
appendix B. Its format is: 

EXPLAIN @ 



Figure 3-6 gives the explanation for the error message, NO 
SUCH COMMAND. 



ASKING FOR COMMAND DESCRIPTIONS 

The HELP command enables a user to request information 
about a specific command. If the user issues the HELP 
command without specifying a command or command 
abbreviation, XEDIT prints a list of all its commands. Its 
formats are: 

HELP, command @ 

H, command @ 

Figure 3-7 shows the description of the HELP command. 



?? ge.t,olan 

MO SUCH COMMAND 

?? explain 

EXPLANATION 0F- 
NO SUCH COMMAND 
. THE COMMAND IS ILLEGAL OR AM TMPRnPRR wpipithq 

WAS USED AFTER THE COMMAND. 



The user enters an illegal command. 
XEDIT prints the appropriate error 
message. The user requests an 
explanation. XEDIT prints the 
explanation of the NO SUCH 
COMMAND message. 



Figure 3-6. Error Message Explanation 



?? help, print 
PRINT $ [P] 



ACTION- PRINTS $ LINES STARTING AT THE CURRENT 
POINTER POSITION. THE POINTER IS LEFT POSITIONED 
AT THE LAST LINE PRINTED. 



The user issues a command asking for 
a description of the PRINT command. 
XEDIT prints a description. 



Figure 3-7. Command Description 
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POSITIONING THE FILE POINTER 



During editing, XEDIT keeps track of its location within 
the edit file by means of a pointer. The pointer is always 
located at the start of the line and is positioned according 
to these rules. 



Condition 

XEDIT is called. 

A command is 
processed. 



Interruption of 
XEDIT output. 

Command pro- 
cessing reaches 
the end-of- 
information. 



Pointer Position 

Beginning-of-information. 

Last line processed by the 
command (usually the last 
line printed in verify mode). 

Last line processed. • 



The message END OF FILE is 
printed, further processing 
of the command stops, and the 
pointer is repositioned at the 
beginning of the file. 



LOCATING LINES VIA LINE NUMBERS 

When editing a file sequenced by line numbers, the user can 
advance the pointer to a line identified by a specific line 
number by entering the line number after a command 
prompt. XEDIT begins its search for the specified line 
number at the current pointer position. The search is 
circular; the top of the file may be passed in order to 
position the pointer at the specified line. Processing of the 
command ends when the pointer is positioned at the line 
having the specified line number. If no such line exists 
within the line number sequence, the pointer is positioned 
at the line with the next highest line number. Its format is: 

line number @ 

Figure 4-1 demonstrates this command. 

A line number may also be used as a prefix to other 
commands. 170PRINT 5 instructs XEDIT to go to line 
number 170 and print five lines. 



POINTER MOVEMENT BY COMMAND 
PREFIXING 

A user can move the pointer before processing an XEDIT 
command by prefixing the command with either a slash or 
an up arrow. 

/ Advances the pointer one line before 

processing the prefixed command. 

A or f Repositions the pointer at the 

beginning-of-information before processing the 
prefixed command. (This character is octal 
76.) 



LOCATING LINES VIA SPECIFIED STRINGS 

The user can advance the pointer to a line containing a 
specific string of alphanumeric characters by issuing a 
LOCATE command. LOCATE commands take three 
different forms. One form applies when the user wants to 
find a line containing a specified string. The second form 
applies when the user wants XEDIT to find a line with the 
first string followed by a second string. The third form 
applies when XEDIT is to find a line with the first string 
not followed by a second string. 

When the user issues a LOCATE command with verify mode 
in effect, XEDIT prints the n lines containing the specified 
string. The pointer is positioned at the last line printed. 



POINTER MOVEMENT COMMANDS 

The XEDIT commands discussed in this section control file 
pointer positioning for processing of editing commands. 



?? 120 ® 

00120 EXT 6533 (D 
?? 140(3) 

001 SO Q.E. SMITH © 

?? 190 (D 

190 P.T. BEE 

?? 170 © 

00170 POB 55 55703 © 



The user issues a line number command to locate line 120. 

XEDIT verifies that the pointer is positioned at line 120. 

The user enters line number 140. 

XEDIT positions the pointer at line 150 because line 140 does not 

exist in this file and 150 is the next highest line number. 

The user enters a 190 to find line 190. 

The user enters a 170 to find line 170. 

XEDIT performs a circular search to find line 170 and prints the 

line. 



Figure 4-1. Locating Lines Via Line Numbers 
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When the user wants to locate a line containing a specific 
string, the formats are: 

T f\S~* .* T1T» /-*. — ^ /_ /^V 

Lwort i ivsirwig/n ^ 



L/string/n @ 
string 



String of alphanumeric characters 
which XEDIT attempts to locate. If 
the user omits the terminating 
delimiter, XEDIT prints an 
informative message and processes 
the command as if a delimiter existed 
after the last nonblank character. 

Number of lines to be located 
containing the specified string. The 
file pointer is positioned at the last 
line located. The maximum value is 
99999; the default value is 1. If n is 
0, the search is restricted to the 
current line. 



The LOCATE command is used in figure 4-2 to find lines 
containing a specified string. 



When the user wants to locate a line that contains a certain 
string followed by another string, the formats are: 

LOCATE/stringl...string2/n @ 

L/stringl...string2/n @ 



stringl...string2 



stringl followed by string?. 
If the user omits the 
terminating delimiter, XEDIT 
assumes one exists after the 
last nonblank chnr?ieter. 

Number of lines to be ; cated 
containing the specified 
strings. The maximum value 
is 99999; the default value is 
1. If n is 0, the search is 
restricted to the current line. 



Figure 4-3 uses the second format of the LOCATE 
command. 



i '. .Locate- zip/ {i) 

00110 1544 WILSHIRE ST ZIP 55722 

?? /locate/zip/2 © 

00170 pop * c ~ m ~: -,5 © 

00200 8710 U'" u ST ~TP SS7 13 

?? 1/87 1 1/0 © 

STRING NOT FOUND © 
99 



The user issues a prefixed LOCATE command to position the 

pointer at the first line containing the string ZIP. 

XEDIT verifies that line 110 is located. 

I he user issues a slash-prefixed LOCATE command to 

advance trie pointer one line before the search. 

XEDIT prints the next two lines containing the string ZIP. 

The user issues an abbreviated LOCATE command with n zero 

<^unt parameter. 

The string 8711 is not found on the current line. 



Figure 4-2. LOCATE With a Specified String 



?? "iocate/wilshire 
END OF FILF © 
?? locate/wilshire. 
no 1 10 15 44 WILSHIPE 

99 



. .zip 55711/® 

.zip 55722/© 
ST ZIP 55722© 



© The user issues a LOCATE command to find a line containing 
the string WILSHIRE followed by the string ZIP 55711. 

© XEDIT reads the end-of-information mark without finding the 
specified string. 

© The user issues a LOCATE command to find a line containing 
the string WILSHIRE followed by the string 55722. 

© XEDIT prints line 110. 



Figure 4-3. LOCATE With Two Specified Strings 
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When the user wants to locate a line that contains a certain 
string not followed by a second string, the formats are: 

LOCATE/stringl — string2/n @ 

L/stringl — string2/n © 

stringl — string2 



stringl not 
string2. 



followed by 



— string2 



If stringl is not specified, 
XEDIT searches for n lines 
not containing string 2. 

Number of lines to be located 
containing stringl not 

followed by string2. The 
maximum value is 99999; the 
default value is 1. If n is 0, 
the search is restricted to the 
current line. 



Figure 4-4 demonstrates the third format of the LOCATE 
command. 



ADVANCING AND REVERSING THE POINTER 

When the user wants to advance the pointer toward the end 
of the file, he enters a NEXT command with one of the 
following formats. 

NEXTn © 

N n © 

n' Number of lines that the pointer is advanced. 
The maximum value is 99999; the default value 
is 1. 



When the user wants to reverse the pointer toward the 
KomnninCT-nf-infnirnfltinn. he enters a NEXT command 
specifying a negative number of lines as follows: 

NEXT-n @ 

N -n © 

n Number of lines that the pointer should be 
moved toward the beginning-of-information. 
Processing ends when the pointer reaches the 
beginning-of-information. The maximum value 
is 99999. If n is or if n is omitted, no pointer 
movement is performed. 

Reverse pointer movements using the NEXT command are 
much slower than forward pointer movements. Figure 4-5 
illustrates pointer movement in both directions. 



POSITIONING POINTER AT TOP OR BOTTOM 
OF FILE 



A user can position the pointer at the 
beginning-of-information by issuing a TOP command in one 
of the following formats. 

TOP @ 

T © 

The user can move the pointer to the bottom of the current 
record in a file by issuing a BOTTOM command in one of 
the following formats. 

BOTTOM © 

-B (cr) 



?? "locate/wilshire/ (T) 

00010 3780 WILSHIRE AVE ZIP 55722 ( 

?? ~locate/wilshire ave/ (3) 

00110 1544- WILSHIRE ST ZIP 55722® 







The user issues a LOCATE command to find a line containing 

the string WILSHIRE. 

XEDIT prints line 10. 

The user issues a LOCATE command to find a line containing 

the string WILSHIRE but not containing the string AVE. 

XEDIT prints line 110. 



Figure 4-4. LOCATE With String Not To Be Found 



?? print 6 Q 

00100 M.T". JONES (2) 

00110 1544 WILSHIRE ST ZIP 55722 

00120 EXTENSION 6533 

00130 A.B. NEWTON 

00140 166 HASKELL CIRCLE ZIP 55713 

00150 EXTENSION 227 

?? next-3 (3) 

00120 EXTENSION 6533© 

?? next 2 (5) 

00140 166 HASKELL CIRCLE ZIP 55713 

99 



The user issues a PRINT command to list six lines. 
XEDIT prints six lines. 



The user issues a NEXT command to reverse the 

pointer three lines. 

XEDIT verifies where the pointer is positioned. 

The user issues a NEXT command to advance the 

pointer two lines. 

XEDIT verifies where the pointer is positioned. 



Figure 4-5. The NEXT Command 
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After positioning the file pointer at the bottom of the 
current record, the pointer can be moved to the bottom of 
the next record bv a nts" ir ' r 

i->\^ i i. \jlii uvjuiiiiailU. 



'uai coiuiiiHnvj anu auotner 



Figure 4-6 uses both the BOTTOM and the TOP commands. 



POSITIONING POINTER BY LISTING LINES 

A user can list lines from a file with the PRINT command. 
This command begins its listing at the current pointer 
position. When the listing is finished, the pointer is 
positioned at the last line printed. If XEDIT reads an 
end-of-information mark, printing stops and the pointer is 
positioned at the beginning of the file. PRINT commands 
have the following formats. 

PRINT n % 

Pn'@ 



Number of lines the user wants printed. The 
maximum value is 99999; the default value is 
1. If n is *, XEDIT prints every line from the 
current pointer position to the 

end-of-information or until 99999 lines have 
been printed. 



Figure 4-7 demonstrates the PRINT command. 



PRINTING THE CURRENT LINE COUNT 

The WHERE command gives the user the current line 
count. Calculated and printed by XEDIT, this is the 
number of lines between the beginning-of-information and 
the current pointer position. The formats are: 

WHERE @ 

W @ 

Figure 4-8 uses the BOTTOM and WHERE commands. 



?? 160 © 

ooi6o q7e. SMITH (2) 

?? top (3) 

?? print0 

### NAMES/ADDRESSES ARE FICTITIOUS ### (D 

?? bottom© 

00210 EXT 18 (7) 

99 



<D 



The usci positiuua the pointer at iine 160. 

XEDIT prints the location of the pointer. 

The user issues a TOP command to position the 

pointer at the first line in the file; no automatic 

verification is done. 

The user issues a PRINT command. 

XEDIT prints the first line in the file. 

The user issues a BOTTOM command to move 

the pointer to the last line in the current record 

of the file. 

XEDIT prints the bottom line of the record. 



Figure 4-6. TOP and BOTTOM 



SMITH 



:th 
:ip 



?? print 

00160 O.F. . 

?? print 4 

00160 Q.E . SM] 

00170 POE 55 ZIP 55 

190 P.T. BEE 

00200 8710 1«TH ST ZIP 55713 

?? print* 

00200 8710 14TH ST ZIP 55713 

002^0 EXT 18 

END OF FILE 

?? print* 

### NAMES/ADDRESSES ARE FICTITIOUS ### 

00100 M.T'. JONES 

00110 1544 WILSHIRB ST ZIP 55722 

00120 EXTENSION 6533 

00160 Q.E. SMITH 

00170 POP 5^ ZIP 55 

190 P.T. PEE 

00200 8710 1HTH ST ZIP 55713 

0021: EXT 18 

END OF FILE 

99 



The user issues a PRINT command to list the current 
line. XEDIT prints line 160. The user issues a PRINT 
command to list four lines. Next, the user lists all lines 
from the current pointer position to the 
end-of-information. XEDIT prints lines 190 through 210 
and the message END OF FILE. The final PRINT 
command lists the entire file because the pointer was 
automatically repositioned to the beginning-of-information 
by the last command. 



Figure 4-7. The PRINT Command 
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?? bottom 

ATTACH, XEDI6U/UN=XSCB, 
?? where 
5 

99 



The user issues a bO'rruM command and a WHtiKJti 
command to find the number of lines in the record. 



Figure 4-8. The BOTTOM and WHERE Commands 
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STRING EDITING 



The user can modify specific strings of alphanumeric 
characters within a file line by issuing string editing 
commands. The following section describes these 
commands in detail. 



ADDING A STRING TO THE 
END OF A LINE 



The user can append a string to the end of one or more file 
lines with an ADD command. After receiving an ADD 
command, XEDIT prints a single question mark (?) to 
prompt entry of the string to be appended. After entry of 
the string, XEDIT prints the lines to which the entered 
string has been- appended starting at the current pointer 
position. The ADD command has the following formats. 

ADD n © 

An @ 

n Number of consecutive lines to which the 
specified string should be appended. The 
pointer is positioned at the last line 
processed. The maximum value for n is 99999; 
the default value is 1. If n is *, n is set at 
99999, and XEDIT processes the command 
from the current pointer position to the 
end-of-information or until the command is 
processed 99999 times. When n is 0, the string. 
is appended to the current line. 

Figure 5-1 is an example of the use of the ADD command. 



REPLACING, DELETING, AND 
INSERTING STRINGS 

CHANGE and CHANGES commands can: 

• Replace one string with a different string. 

• Delete strings from file lines. 

• Insert strings at the beginning of a line or at the 
beginning of a window set by the WMARGIN 
command. 

The CHANGE command replaces all occurrences of a given 
string in the number of lines specified. The CHANGES 
command replaces the number of occurrences specified of 
the given string. 

The windowing feature can also restrict the columns in 
which the change can occur. If the user prefers to change 
strings by visual eharacter-by-eharaeter alignment instead 
of by context, he can use the MODIFY command described 
later in this section. 



REPLACING STRINGS BY CONTEXT 

The user can replace one string with a different string of 
any length and character content with a CHANGE or 
CHANGES command. However, to use the edited file 
within NOS, the user must not create a file line longer than 
150 characters. The search for the first specified string 
starts at the line designated by the current pointer position. 



?? add 3 

? (senior 

00090 B.J. 

00100 A.J. 

00110 B.R. 

?? next 2 

00130 Y.R. RATTZ 

?? a 

? (junior 

00130 Y.R. 



advisor) 

MASSY (SENIOR ADVISOR) 
HOUSE (SENIOR ADVISOR) 
JONES (SENIOR ADVISOR) 



advisor) (D 

RATTZ (JUNIOR ADVISOR) 



® The user tells XEDIT to add (SENIOR ADVISOR) to the 
end of three lines starting at the current position of 
the pointer. 



(2) The user teUs XEDIT to add (JUNIOR ADVISOR) to the 
end of the line which contains the pointer. 



Figure 5-1. The ADD Command 



60455730 B 



5-1 



The formats for replacing strings by content are: 
CHANG E/stringI/string2/n @ 
C/stringl/string2/n @ 

or 
CHANGE/stringla...stringlb/string2/n @ 
C/stringla...stringlb/string2/n @ 

or 
CHANGES/stringl/string2/m @ 
CS/stringl/string2/m @ 

or 
CHANGES/stringla...stringlb/string2/m @) 
CS/stringla...stringlb/string2/m @ 



stringl 
stringla...stringlb 



String to be replaced. 

Stringl a followed by 
string! b. Ail characters 
between and including 
these two strings are 
replaced by string2. 

string2 String to replace stringl 

(can be any length). 

n Number of lines containing 

an occurrence of stringl 
which should be changed. 
XEDIT changes every 
occurrence of stringl or 
stringl a...stringlb in the 
specified lines. If n is 
omitted, XEDIT changes 
the first line found 
containing stringl. 

Maximum value is 99999. 
If n is *, XEDIT replaces 
every occurrence of stringl 
between the curent pointer 
position and the end of 
information or until stringl 
is replaced 99999 times. If 
n is 0, the search for 
stringl is restricted to the 
current line. 

m Number of occurrences of 

stringl or stringla.'.. 

stringlb that are to be 
replaced. If the user omits 
the m value, XEDIT 
replaces only the next 
occurrence of the string. 

Figure 5-2 shows the use of the CHANGE and CHANGES 
commands. 



DELETING STRINGS BY CONTEXT 

CHANGE or CHANGES commands can also be used to 
delete a string by omitting string2. These commands begin 
editing at the current line position and continue through n 
file lines or m occurrences of stringl. These formats are: 

CHANGE/stringl//n @ 

C/stringl//n @ 

or 

CHANGE/stringla...stringlb//n @ 
C/stringla...stringlb//n @ 



CHANGES/stringl//m @ 
CS/stringl//m @ 
or 

CHANGES/stringla...stringlb//m @ 
CS/stringla...stringlb//m © 
stringl 



stringla...stringlb 



String of charcters to be 
deleted. 

stringla followed by 
stringlb. All characters 
within and between these 
two strings in a line are 
deleted. 

n Number of lines containing 

stringl that should be 
processed by this 

command. Maximum value 
is 99999; the default value 
is 1. If n is *, every line is 
deleted from the current 
pointer position to the end 
of information or until 
99999 lines have been 
deleted. If n is 0, XEDIT 
does not advance the 
pointer, and only the 
current line may be deleted. 

m Number of occurrences of 

stringl or stringla... 
stringlb to be deleted. If 
the user omits the m value, 
XEDIT deletes only the 
next occurrence of the 
string. 

The CHANGE and CHANGES commands can delete 
selected lines as shown in figure 5-3. 



5-2 
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INSERTING STRINGS AT THE BEGINNING string2 String of characters which the user 

character of a line. 



V-T A LIINC 



A user can insert a string before the first (leftmost) n Number of lines before which string2 

character of a line using a CHANGE or CHANGES is to be inserted. The maximum 

command. To do this, he omits stringl. The formats are: value is 99999; the default value is 1. 

If n is *, XEDIT inserts string2 before 
CHANGE//string2/n @ every line from the current pointer 

position to the end-of-information or 
C//string2/n @ until 99999 strings have been 

inserted. If n is 0, XEDIT does not 
CHANGES//string2/n @ advance the pointer, and the insertion 

occurs at the current pointer position. 

CS//string2/ n Figure 5-4 shows insertion of a string using the CHANGE 

command. 



?? prirt* (D 


<D 


The user issues a PRINT command to list the entire 


*## NAMES/ADDRESSES ARE FICTITIOUS ### 




file. 


00100 M.T.JONES 






00110 1244 WILSHIRE ST ZIP 55722 






00120 EXT' 65^n 






00160 O.F. SMITH 






00170 POB 55 ZIP 5570? 






00180 EXT 8837 






00190 P.T. REE 






00200 8710 14TH ST ZIP 55713 






00210 EXT 18 






END OF FILE 






?? change/ext /853-/*(D 


(D 


The user issues a CHANGE command to replace every 


00120 853-6533 




instance of EXT in file to 853-. XEDIT verifies which 


00180 853-8837 




lines are changed. 


00210 853-18 






END OF FILE 






?? 190 (3) 


<S> 


The user locates line 190 and changes the name BEE to 


00190 P.T. BEE 




BEAN. 


?? c/bee/bean/ . 






00190 P.T. BEAN 






?? 170cs/55/49/ © 


<D 


To change the post office box number without 


00170 POB 49 ZIP 55703 




changing the zip code on line 170, the user issues an 


?? 




abbreviated CHANGES command. 



Figure 5-2. Use of CHANGE and CHANGES to Modify Lines 



?? print* (D 


(D 


The user lists the file. 


#*# NAMES/ ADDRESSES ARE FICTITIOUS ### 






00100 M.T.JONES 






00110 1244 WILSHIRF ST ZIP 55722 






00120 EXT 6533 






00160 Q.E . SMITH 






00170 POB 55 ZIP 55703 






00180 EXT 88?7 






00190 P. TEE BEF 






00200 8710 14TH ST ZIP 55713 






00210 EXT 18 






END OF FILE 






?? change/zip//* (2) 


® 


The user issues a CHANGE command to delete every 


00110 1244 WILSHIRE ST 55722 (3) 




occurrence of the string ZIP from every line in the file. 


001 7 POB 55 55703 


© 


XEDIT prints the edited lines. 


00200 8710 14TH ST 55713 






END OF FILE 






?? 190changes/ee// © 


@ 


The user then corrects the name in line 190 by issuing 


00190 P.T BEE 




a CHANGES command. 


?? 







Figure 5-3. Selective Deletion via CHANGE and CHANGES Commands 
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?? print3 (T) 

00 100 M.T. JONES 

00110 1544 WILSHIRE ST ZIP 55722 

00120 EXT' 6533 

?? ~change//ex/3 (D 

SX00100 M.T. JONES 

EX00110 1544 WILSHIRE ST ZIP 55722 

EX00120 EXT 6533 



Q The user lists three lines. 



(2) The user inserts the string EX before each of the three 
lines. 



Figure 5-4. Use of CHANGE to Insert a String 



RESTRICTING THE STRING SEARCH 

The user can restrict the search for a string by issuing one 
of the following commands. 

TRIM @ Ignores trailing blanks in lines 

searched by the string search 
command. 

WMARGIN @ Defines column setting which restrict 
the sco 1 "*? of a strin 0- search command 
when used with the W or A command 
suffix characters. 

IGNORING TRAILING BLANKS 

A user can tell XEDIT to ignore trailing blanks on string 
searches by issuing the TRIM command. The TRIM 
command has three formats. 

TRIM+ @ Ignores trailing blanks. 

TRIM- @ Uses -trailing blanks. 

TRIM (g) Toggles the TRIM setting. 

The commands whose searches are limited by the TRIM 
command are: 

CHANGE 

CHANGES 

COPY 

COPYD 

DELETE 

LOCATE 

OCTCHANGE 



Lines that are entirely blank are not searched when XEDIT 
ignores trailing blanks. The TRIM command alters searches 
as shown in figure 5-5. 



DEFINING A WINDOW 

A user can restrict the scope of a string search to a 
specified range of columns through use of the WMARGIN 

wiiiuuiiu. w"v-i- <-iic YYiiiuuw Cuxunius nave ucen ueiifieu, 

the user can ask for a search restricted to those columns. 
The user makes that request by appending a W or an A 
suffix character to the end of any string search command 
(for example, CHANGEW and LOCATEA). To set the left 
and right window margin columns, the WMARGIN command 
is used as follows: 

WMARGIN lm rm @ 
WM lm rm @ 

lm Column position setting of the left 

window margin. 

rm Column position setting of the right 

window margin. 

The left margin must be less than or equal to the right 
margin. 



?? print* (T) 

■EXECUTIVE MAMAGEMEM r 

EX00100 A.B. KRAMER 

EX00110 J.J. JOHNSON 

EX00130 B.C. MILLER 

END OF FILE 

?? locate/130 / (2) 

EX00100 A.B. KRAMER 

?? trim (3) 

?? "locate/130 / 

EX00130 B.C. M ILLER 
99 



HOR24130 
SWP19 130 
HOR44130 



HQR24130 



® The user lists the file. 



(D The user attempts to find manager number 130 but instead finds 

manager number 100 with the facility number HQR24130. 
(3) The user issues a TRIM command. 



HQR4U130(4) @ XEDIT now locates the desired line. 



Figure 5-5. The TRIM Command 
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USING A WINDOW 

Once a window has been defined by the WMARGIN 
command, the user can request that a search be restricted 
to those columns by appending either a W or A suffix 
character to the end of any string search command. The 
legal commands are: 



CHANGEW 

CHANGEA 

CHANGESW 

CHANGESA 

COPYW 

COPYA 



COPYDW 

COPYDA 

DELETEW 

DELETEA 

LOCATEW 

LOCATEA 



A suffix character can also be appended to the 
corresponding command abbreviations. 



The W or window suffix character requires that all 
characters of the string specified by the command reside 
within the window; otherwise, XEDIT does not find the 
string. 

The A or anchor suffix character requires that the first 
character of the string specified by the command reside 
within the window; otherwise, XEDIT does not find the 
string. All other characters can extend beyond the window. 

These suffix characters are used in figure 5-6. 

The windowing restriction is used to search an employee 
directory in figure 5-7. 



?? D (D 


(D 


The user lists his one-line file. 


APCDEFGHIJKLM 






?? wtnargin 4 1 1 (2) 


© 


User sets the window margins to columns 4 and 11 (defghijk inclusive). 


?? lw/ef. ..ij/(D 


@ 


User then tries various commands on this file. 


ABCDEFGHIJKLM® 


3) 


XEDIT finds the string and prints out the line containing it, or XEDIT 


?? lw/ef m/ 




searches to the end-of -information without finding the string. 


APCDEFGHIJKLM 






?? lw/cdef . . .ij/ 






END OF FILE 






?? lw/ef— h/ 






END OF FILE 






?? la/ef. . . klm-/ 






APCDEFGHIJKLM 






?? la/klm/ 






APCDEFGHIJKLM 






?? la/ef-!— m/ 







Figure 5-6. Use of the Suffix Characters 



?? p* g> 

DEPT'4208 EMP927 KRAMER, SCOTT W. 

DEPT4P08 EMP208 JOHNSON, JACK J. 

DEPT'4208 EMP742 MILLER, RICK E. 

DEPT4208 EMP698 SCOTT, FRANK R. 

END OF FILE 

?? wmargin 10 15 (2) 

?? lw/208/ (3) 

DEPT'4208 EMP208 JOHNSON, JACK J.0 

?? win 17 17 CD 

?? *la/scott/® 

DFPT4208 3MP698 SCOTT, FRANK R . © 



Q The user lists the file. 



User defines the window°as columns 10 through 15. 

To locate employee number 208, the user enters an 

abbreviated LOCATE command with the suffix W so that 

XEDIT searches only the employee number field. 

XEDIT finds employee number 208, Jack Johnson. 

To find the first employee whose last name is Scott, the 

user redefines the window to be column 17 only. 

The user issues an abbreviated LOCATE command with 

the suffix A. 

XEDIT correctly finds the name Frank Scott. 



Figure 5-7. Restricting Field of Search 
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MODIFYING STRINGS CHARACTER-BY- 
CHARACTER 

Three XEDIT commands enable users to alter the contents 
of a line on a charaeter-by-character basis. t They are 
MODIFY, QMOD, and YQMOD. These commands differ 
only in the alignment guides they provide for the 
modification directives and in the number of lines a single 
command can modify. The alignment guide for the 
MODIFY command is the contents of the line at the 
current pointer position. MODIFY can change only one line 
at a time. QMOD provides a row of column numbers as an 
alignment guide for the modification directives and 
executes those directives on the number of lines specified. 
YQMOD does not provide an alignment guide but is 
otherwise identical to QMOD. The procedure for using 
these commands is: 



1. Position the file pointer at the first line to be 
modified. 

2. Issue a modifying command (MODIFY, QMOD or 
YQMOD). 

3. XEDIT prints the alignment guide, and on the 
subsequent line, a single question mark. 

4. Align and enter the appropriate modification 
directives under the character or column to be 
modified (refer to table 5-1). 

5. XEDIT prints the modified line or lines. 

If no modification directives are entered after the single 
question mark, no changes are made and no verification is 
given. The prefixed command X YQMOD suppresses the 
printing of the alignment guide and the modified lines. 



TABLE 5-1. MODIFICATION DIRECTIVES 



Directive 



f string* 



Blank space 



Other alpha- 
i numeric 
characters 



Function 



XEDIT inserts the string of alphanumeric char- 



+ £ST»0 K/Tl + 



en the y and the # before the 



act 

character pointed to by the f 

Issuing a f # combination places a # in the 
file line. If an 6c or a f is part of the 
string entered, that special character is 
treated as a normal character instead of a 
directive. If a f appears before a string 
but the terminating # is missing, XEDIT assumes 
the # should appear after the last nonblank 
character in the directives line. 



When a f is entered without any trailing char- 
acters, XEDIT inserts a blank in front of the 
character above the f . 



When a # is entered without a preceding f , 
XEDIT deletes the character above the # and 
closes up the space left by the deletion. 



The character above a blank is left un- 
changed. 



XEDIT deletes the character above an <5c and 
replaces it with a blank. 



The character in the file line is replaced by 
the charcter in the directives line. 



Example 



?? 200modify 

00200 8710 liiTH ST ZIP 55713 
? t south* 

00200 8710 SOUTH 1 UTF ST ZIP 5571? 

99 



?? 110modify 

00110 154ii WILSHIREST 
? 
001 10 I 5 44 WILSFIRE ST 

99 



?? 170raodifv 

00170 POB 55 ZIP 55703 
? # 
00170 PO 55 ZIP 55703 

99 



?? 200modify 

00200 8710 SOUTH 1 *»TH ST 

9 



?? lOOmodify 

00100 M.T.RJONES 
? & 

00100 M.T. JONES 

99 



?? I60modify 

00160 Q.E. SMITH 
? Y e 

00160 Q.E. SMYTHE 

99 
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1 NOTE J 

The user should not allow a modified line 
to exceed 150 characters. In IAF, the 
user should set the page width at the 
maximum number of characters that he 
wants to appear on a line. 



The following are the formats of the three modification 
commands and examples of their use. 

MODIFY @ 

M ® 

Figure 5-8 shows the MODIFY command. 

QMOD n @ 

QMn @ 

n Number of lines starting at the current pointer 
position that is to be modified. The maximum 
value is 99999; the default value is I. If n is *, 



XEDIT modifies every line from the pointer 
position to the end-of-information or until 
99999 lines have been modified. 

QMOD is often used when each line of a file consists of a 
series of fields each covering a specified range of columns 
as shown in figure 5-9. Although the alignment guide shows 
only 70 characters, the user can modify more than 70 
characters if the defined line length is larger than 70. 

YQMOD n @ 

YQM n @ 

n Number of lines to be modified by the line of 
modification directives. The maximum value 
is 99999; the default value is 1. If n is *, 
XEDIT modifies all lines from the current 
pointer position to the end-of-information or 
until 99999 lines have been modified. If n is 0, 
the line at the current pointer position is 
modified. 

Figure 5-10 shows a similar editing operation performed 
with the YOMOD command. 



?? modify ® 


® 


The user enters the MODIFY command. 


TM TEXT TO BE MODIDIED (D 


(1) 


XEDIT lists the line. 


? e f ® 


Q) 


The user corrects spelling mistakes by 


THE TEXT TO BE MODIFIED 




entering E and F. 


?? /modify ® 


@ 


The user moves the pointer one line and 


MOVE THIS LINE OVER 5 SPACES. 
? " # 

MOVE THIS LIME OVER 5 SPACES. 




modifies that line by adding 5 blanks. 






?? /m 






DELETE A STRING IN THIS LINE. 






? ##### (D 


(D 


The user enters #### to delete THIS. 


DELETE A STRING IN LINE. 






?? /m 






ADD A STRING TO THIS LINE. 






? "short # © 


(D 


The user adds the word SHORT by using „. 


ADD A SHORT STRING TO THIS LINE. 




the f and #. 


?? 







Figure 5-8. The MODIFY Command 
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?? print* 






— 


uuiuu rani imu= / ny IcLd. 


0UAN= 757 


VALUE = 945.'50 




00110 PART NOs 749323 


0UAN= 129S 


VALUE= 23.95 




00 120 PART" NO= 74932U 


QUANs 446 


VALUE= 138.05 




00110 PART NO= 749325 


0UAN= 15 


VALUE= 1650.50 




00140 PART NO= 749326 


0UAN= 376 


VALUE= 182.75 




END OF FILE 








?? qmod* 








1 -2 


3 


4 5 fi ■ 




123456789O123456789012345678901234567890123456789012345678901234567890 




? "_# 




cost# 




00100 PART NOs 7493-22 


QUAN= 757 


COST'S 9 45.50 




001 10 PART N()= 7493-23 


QUAN= 1298 


CC)ST= 23.95 




00120 PART N0= 7493-24 


QUA M= 446 


COSTs 138.05 




00130 PART NOs 7493-25 


QUAN= 15 


COSTs 1650.50 




00140 PART NOs 7493-26 


QUAN= 376 


COSTs 182.75 




END OF FILE 









In the first entry, the user issues a PRINT command to list the entire file. XEDIT lists the 
file. In the next entry, the user issues a QMOD command with n equal to *, indicating that 
his subsequent modification directives should change every file line. XEDIT prints a sequence 
of column numbers and a single question mark prompt. The user enters appropriate 
modification directives in the directives line (a hyphen in front of column 20 and the word 
COST replacing the word VALUE at column 42). XEDIT verifies the modifications in the file. 



Figure 5-9. The QMOD Command 



?? top 

?? print* 

00100 PART M()= 7493-22 QUAN= 757 

00110 PART NO= 7493-23 OUANs 1298 

00 12^ PART NO= 7493-24 QUAN= 446 

00130 PART NOs 7493-25 OUANs 

00140 PART NO= 7493-26 0UAN= 

END OF FILE 

?? yamod^* 

? "factory # 

00100 FACTORY PART NOs 749 3-22 

00 110 FACTORY PART NO= 749 3-23 

00120 FACTORY PART NO= 7493-24 

00130 FACTORY PART NOs 749 3-25 

0014C FACTORY PART NOs 749 3-26 

END OF FILE 

79 



15 

376 



QUANs 
0UAN= 
QUAN= 
QUAN = 
QUAN= 



COSTs 
COSTs 
COSTs 
COSTs 
COSTs 



757 

1298 

446 

15 

376 



945.50 

23.95 

138.05 

1650.50 

182.75 



COST= 9 45.50 

COSTs 23.95 

COSTs 138.05 

COSTs 1650.50 

COSTs 182.75 



The user lists the entire 
file -and then enters a 
YQMOD command specify- 
ing that every line in the 
file is to be modified. 
XEDIT prints a single 
question mark. The user 
counts over seven spaces 
and inserts the word 
FACTORY before column 
7. XEDIT verifies the 
modification made in the 
file. 



Figure 5-10. The YQMOD Command 



5-8 



60455730 B 



LINE EDITING 



A user can change entire lines within a file with XEDIT line 
editing commands. These commands are discussed in the 
following section. 



DELETING LINES 

A user can delete entire lines from a file by using any of 
the following criteria. 

• A sequence of lines starting at the current pointer 
position. 

• Selective lines on the basis of a specified string. 

• A single line with a specified string without moving 
the file pointer if the string is not found. 

• Selective lines if a specified string occurs within a 
specified set of columns (refer to the WMARGIN 
command). 

• Selective lines when they are copied to another file 
(refer to the COPYD command). 

The first three listed use the DELETE command. The 
DELETE command leaves the file pointer positioned at the 
line after the last deleted line. The formats are: 

DELETE n @ 

D n £r) 



n Number of lines starting at the current pointer 
position that is to be deleted. The maximum 
value is 99999; the default value is 1. If n is *, 
XEDIT deletes all lines from the current 
pointer position to the end-of-information or 
until 99999 lines have been deleted. If n is 0, 
the line at the current pointer position is 
deleted. 

This format of the DELETE command is used in figure 6-1. 

DELETE/string/n @ 

D/string/n @) 

string String of characters that determines 

if a line should be deleted. 

n Number of lines containing the 

specified string that is to be deleted. 
The search starts at the current 
pointer position. The maximum value 
is 99999; the default value is 1. If n 
is *, XEDIT deletes every line from 
the current pointer position to the 
end-of-information or until 99999 
lines have been deleted. If n is 0, the 
line at the current pointer position is 
deleted if it contains the specified 
string. - ' 



?? 130® ^ 

00130 B.P. PEEPERS© 

?? delete 3 

00130 B.P. PEEPERS 

00140 116 WEST ELM DRIVE ZIP 55648 

00150 EXT 3222 

?? 190© 

00190 P. T". BEE 

?? xdelete* 

END OF FILE 



(T) The user positions the file pointer at line 130 

issues a DELETE command to delete three lines. 
(D XEDIT verifies the lines deleted. 



and 



(D The user next positions the pointer to line 190 and then 
issues a DELETE command to remove all lines from 
line 190 to the end-of-information. XEDIT indicates 
that the end-of-information was encountered but does 
not verify which lines were deleted because an x prefix 
was used on the DELETE command. 



Figure 6-1. Deleting Selected Consecutive Lines 
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This second format of the DELETE command is used in 
figure 6-2. 



DELETE/stringl — string2/n @ 



r\PI T?T>T? /_+_:_ 



uu i ij/ Siring!. ..Siring^/ n pi 

D/stringl...string2/n @ 

stringl...string2 stringl followed by string2. If 
XEDIT finds stringl followed 
by string2 in a line, that line is 
deleted. Any number of other 
characters may separate the 
two strings within the line. 

n Number of lines containing 

stringl followed by string2 
that should be deleted. The 
maximum value is 99999; the 
default value is 1. If n is *, 
XEDIT deletes every line 
containing stringl followed by 
string2 from the current 
pointer position to the 
end-of-information or until 
99999 lines have been deleted. 
If n is 0, the line at the 
current pointer position is 
u6i8icu u it contains string! 
followed by string2. 

Figure 6-3 shows line deletion on the basis of two specified 
strings. 



u/stringl — string2/n (cr) 
stringl — string2 



stringl is not followed by 
string2. If XEDIT finds string! 
without string2 following it in 
the same line, that line is 
deleted. 

Number of lines containing 
stringl not followed by string2 
that should be deleted. The 
maximum value is 99999; the 
default value is 1. If n is *, 
XEDIT deletes every line 
containing stringl not followed 
by string2 from the current 
pointer position to the 
end-of-information or until 
99599 lines have been deleted. 
If n is 0, the line at the 
current pointer position is 
deleted if it contains stringl 
not followed by string2. 



REPLACING LINES 

The REPLACE command allows the user to replace a 
specific number of existing file lines starting at the current 
pointer position with the same number of substitute lines. 
After the user issues the command, XEDIT prints a single 



?? delete/ext/*® 
00120 EXT 6533© 
00150 EXT 5339 
001«0 EXT 67 
00210 EXT 1 101 
END OF FILE 



© The user issues a DELETE command to delete every line in the file containing 

the string EXT starting at the current pointer position. 
(2) XEDIT verifies the lines deleted. 



Figure 6-2. Deleting Lines Containing a Specified String 



?? print*® 
00100 M.T". JONES 

1544 WILSHIRE 

EXT 6533 

A.B. MACDONALD 

1313 LEMONTREE 

EXT 5 339 



© The user lists the entire file. 



00110 

00120 

00130 

00140 

00150 

00160 T.G. 

00170 322 

OOldO EXT 

00190 R.C. 

00200 6100 

00210 EXT 1 101 

END OF FILE 

?? delete/wilsbire st. 

00 110 15h4 WILSHIRE ST 

00200 6100 WILSHIRE ST 

END OF FILE 

79 



ST ZIP CODE 55722 



AVE ZIP CODE 55722 



SLATER 
WILSHIRE ST ZIP CODE 55723 
67 

CARTER 

WILSHIRE ST ZIP CODE 55722 



.55722/*© 

ZIP CODE 55722© 

ZIP CODE 55722 



© The user then issues a DELETE command to 
remove every line in the file that contains the 
string WILSHIRE ST followed by the string 
55722. 5 

© XEDIT verifies which lines are deleted. 



Figure 6-3. Deleting Lines Containing Two Specified Strings 



6-2 
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question mark to inform the user that he should enter his 
first substitute line. XEDIT continues to print single 
question mark prompts until the specified number of 
substitute lines has been entered. If the user enters a 
carriage return immediately after the ? prompt, XEDIT 
stops processing the REPLACE command and requests the 
next command. To replace a line with a blank line, the 
user must enter a space before the carriage return. The 
formats are: 

REPLACE n @ 

R n @ 

n Number of consecutive lines starting at the 
current pointer position that is to be replaced. 
The maximum value is 99999; the default value 
is 1. If n is *, XEDIT replaces every line from 
• the current pointer position to the 
end-of-information or until 99999 lines have 
been replaced. If n is 0, XEDIT replaces the 
line at the current pointer position. 

Figure 6-4 is an example of the use of the REPLACE 
command. 



INSERTING LINES 

The user can insert entire new lines into a file, without 
affecting any existing lines, in three different ways. 

• INSERT commands insert a specific number of lines 
after the current pointer position. 



• INSERTB commands insert a specific number of 
lines before the current pointer position. 

• Entering INPUT mode inserts any number of lines 
after the current pointer position. 



INSERT COMMAND 

The INSERT command lets a user insert a specific number 
of lines into a file immediately after the line at the current 
pointer position. When the user enters the INSERT 
command, XEDIT prints a single question mark to prompt 
entry of the first line to be inserted. XEDIT continues to 
print single question mark prompts until the specified 
number of lines to be inserted has been entered. If the user 
enters a carriage return immediately after the ? prompt, 
XEDIT stops processing the INSERT command and requests 
the next command. To insert a blank line, the user enters a 
space before the carriage return. After processing an 
INSERT command, the file pointer is positioned at the last 
line inserted.- The formats are: 

INSERT n @ 

I n @ 

n Number of lines which the user wants to 

insert. The maximum value is 99999; the 

default value is 1. If n is 0, XEDIT assumes 
that one line is to be inserted. 

Figure 6-5 demonstrates the INSERT command. 



?? 170© 


(D 


The user positions the pointer at line .170 and 


00170 322 WILSHIRE ST ZIP CODE 55723 




then issues a REPLACE command to replace 


?? replace2 




line 170 and the line following it. 


? 00170 18 park place apt 111 zip 55704 




XEDIT prints a single ?. 


? 00180 ext 8866 (?) 




The user enters a modified address. 


77 


(2) 


XEDIT prints a. second ?■ prompt. 


- 




The user enters a modified extension number. 



Figure 6-4. The REPLACE Command 



?? 12 

00120 
?? in 
? 001 
? 001 
? 001 

?? *D 

### N 
00100 
001 10 
00120 

oono 

00140 
00150 
00160 
00170 
00180 
00190 
00200 
00210 
END 

9? 



o® 

EXT 6533 
sert 3(f) 
30 a.b. newton® 

40 166 haskell circle zip 55713® 
50 ext 227© 
rint*© 
AMES/ADDRESSES ARE FICTITIOUS ### 

M.T. JONES 

15^4 WILSHIRE ST ZIP CODE 55722 

EXT 6533 

A.B. NEWTON 

166 HASKELL CIRCLE ZIP 55713 

EXT 227 

T.G. SLATER 

322 WILSHIRE ST ZIP CODE 55723 

EXT 67 

R.C. CARTER 

6100 WILSHIRE ST ZIP CODE 55722 

EXT 1 101 
F FILE 



The user positions the pointer at line 120. 

User then issues an INSERT command to insert 

three lines after line 120. 

XEDIT prints a single question mark and the user 

enters a line containing an employee name. 

The user enters a line containing an address. 

The user enters a line containing a phone extension. 

The user lists the entire file to check if the new 

lines, 130 to 150, were inserted correctly. 



Figure 6-5. The INSERT Command 
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INSERTB COMMAND 

Wnen the user wants to insert a specific number of lines 
into a file before the line at the current pointer position, 
he issues an INSERTB command which indicates how many 
lines are to be inserted. Entry of the lines to be inserted is 
the same as for the INSERT command. The "first line 
entered is the first line of the insertion sequence within the 
file. After processing an INSERTB command, the pointer is 
at the same position it occupied before the command was 
issued. The formats are: 

INSERTB n @ 

IB n @ 

n Number of lines which the user wants to 
insert. The maximum value is 99999; the 
default value is 1. If n is 0, XEDIT assumes 
that one line is to be inserted. 

Figure 6-6 shows the use of the INSERTB command. 



INPUT MODE 

Input mode enables a user to insert an unspecified number 
of lines following the current file pointer position. To 
enter input mode, the user performs one of the following. ■ 

• Presses carriage return immediately after a ?? 
prompt. 

• Enters the INPUT command. 

• Enters the INPUT command followed *by the desired 
escape character. 



XEDIT prints the message INPUT, and on the following 
line, a single question mark. This indicates that the user is 
in input mode and can enter the first line to be inserted. 
XEDIT continues to print ? prompts until the user leaves 
input mode. 

The user can leave input mode by entering one of the 
following after a single question mark prompt. 

• A carriage return. 

• The EDIT command prefixed by the escape 
character. 

Batch origin jobs cannot use the carriage return method. 
They must enter input mode by the INPUT command 
followed by an escape character and leave input mode by 
the EDIT command prefixed by the escape character. 

If an escape character is specified when entering input 
mode, the user can process XEDIT commands prefixed by 
the escape character while in input mode. He is restricted*, 
however, to commands which do not move the file pointer 
(such as REPLACE instead of DELETE). Whenever the 
escape character is in the first character position of a line, 
XEDIT attempts to process the rest of the line as a 
command. If the command entered after the escape 
character would move the file pointer, XEDIT prints the 
message 

COMMAND NOT VALID 

If the command specifies a repetition parameter (n or m) 
other than null or zero, XEDIT prints the message 

ARGUMENT ERROR 

and the command is not processed. Processing continues in 
input mode. 



?? 

001 

?? 

?'o 

? 

? 

?? 

001 

001 

001 

001 

001 

001 

99 



160® 

60 T.G. SLATER 

insertb 3(2) 

0157 a. p. macdonald® 

0158 1313 lemontree ave zip 55722 

0159 ext 5-339 
U0print6@ 

40 166 HASKELL CIRCLE ZIP 55713 
50 EXT 227 

57 A. P. MACDONALD 

58 1313 LEMONTREE AVE ZIP 55722 

59 EXT 5339 



60 



SLATER 



(T) The user positions the pointer at line 160. 

(2) User then issues an INSERTB command to insert 
three lines before line 160. 

(3) The first line entered is line 157 which is to be 
the top line of the inserted sequence. 

The following two lines are inserted. 

(4) The user lists the sequence to check if the lines 
were inserted correctly. 



Figure 6-6. The INSERTB Command 
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The escape character is recognized as such only when it is 
in the first column of a line. Therefore, "if the tab 
character is the same as the escape character, the tab 
character is effective in all columns except the first. If 
placed there, the rest of the line is interpreted as a 
command. 

The following formats are valid for the INPUT and EDIT 
commands. 

INPUT e @ 

eEDIT @ 



The escape character may be any character 

eXf?ent SnflfP Cir tho fnmmanrl HaHmi+^n ^._* u.. 
c- -c -"*- vvuiiuuiiu uwniiHci act L>y 

the DELIMIT command (refer to section 10). 
When INPUT,, is entered, a comma becomes 
the escape character. 



Figure 6-7 uses the INPUT command to enter input mode. 
Figure 6-8 uses @ to enter input mode. 



?? 120® 

00120 EXT 
?? input $ 

INPUT® 
? 00121 m. 
? Change/ 

00121 M.'C. 
? 00122 86 
? Sedit® 

EDIT 

99 



6533 
® 

c gr 
eee/e 

GREE 

7 mis 



eeenwav 
e/® . 
NWAY® 

sion st zip 



55744® 



The user positions the pointer at line 120. 

The user then issues the INPUT command with- a dollar sign 

($) as the escape character. 

XEDIT indicates that it is ready to accept lines to be inserted 

after the current pointer position. 

After entering a line, the user -notices he misspelled 

GREENWAY and issues a CHANGE command prefixed by the 

escape character ($). 

XEDIT verifies that the change was made. 

The user inserts another line of text. 

The user enters the EDIT command prefixed by the escape 

character to leave input mode. 



Figure 6-7. The INPUT Command 



?? 120® 
00120 EXT 6533 
?? ® 

INPUT" 
9 00121 mrc. greenway® 

00122 867 mission st zip 55744 

00123 ext 1500 

00124 sDecial class**supervisor 

00125 emp: 12 

00126 list: c 



© 



? 

9 
9 
9 

?© 

EniT 
?? t 
?? p 

### NAMES/ ADDRESSES ARE FICTITIOUS ### 
00100 M.T". JONES 
00110 1544 WILSHIRE ST ZIP CODE 55722 

00120 EXT 6533 

00121 M.C. GREENWAY 

00122 867 MISSION ST ZIP 55744 

00123 EXT" 1500 



® The user positions the pointer to line 120. 



® The user presses carriage return to enter input 

mode. 
® The user inserts a series of lines. 



® The user presses carriage return to leave input 

mode. 
® The user issues abbreviated TOP and PRINT 

commands to list the entire file. 



ounoo 



ju ranv iown 



ClCl 1 Oil CDCCT AT 

00125 EMP: 12 

00126 LIST: C 
00130 A.E. NEWTON 

00140 166 HASKELL CIRCLE ZIP 55713 

00150 EXT 227 

00157 A. P. MACDONALD 

001^8 1313 LEMON 

??© 



® The user interrupts the listing. 



Figure 6-8. The @ Command 
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EDITING LINE NUMBERS 



The user can issued commands to modify the line numbers 
that sequence a file. These general conventions apply to 
all line numbering commands. 

• Before any line numbering command is processed, 
the file pointer is automatically set to the 
beginning of the file. 

• After processing all line numbers within a file and 
reading the end-of-information mark, XEDIT prints 
the message END OF FILE to indicate that the 
specified line number editing is finished. The 
pointer is automatically repositioned to the 
beginning of the file. 

• A line numbering ^command must not cause the 
edited file line to exceed 150 characters if the file 
is to be processed under NOS. 

• No line number can exceed a value of 99999. If a 
line numbering command would break this rule, the 
file is restored to its original condition, an 
informative message is printed, and the pointer is 
positioned at the beginning of the file. 

• Line numbering commands are primarily intended 
for editing line-numbered card-image text files and 
programs written in time-sharing FORTRAN. 
These commands are not practical for use on 
BASIC programs, since BASIC branch line numbers 
are not modified by these commands. 

• XEDIT does not verify the effects of any line 
numbering command. 



ADDING LINE NUMBERS 

Two XEDIT commands allow users to add line numbers to a 
file. 



ADDLN 



Inserts a line number before each line. 



• ADDLNS Inserts a line number an a blank space 
before each line. 

If line, numbers already exist in the file, ADDLN and 
ADDLNS insert an additional set of line numbers. 



AD-D.LN COMMAND 

When a user wants to add a line number without a trailing 
space to each - line in a file, he can enter an ADDLN 
command in one of the following formats: 

ADDLN In n @ 

ALN In n @ 

In Line number to be inserted before the first 
line in a file. No line number can exceed 
99999. The .default is 1. 

n Number by which each line number in the file 
is incremented. No line number can exceed a 
value of 99999. The default value is 1. 

Figure 7-1 is an example of this command. 



?? p* 

M.T. 


® 

JONES 


EXT' 


WILSHIRE 
6533 


A.B. 


NEWTON ■= 


166 


HASKELL CI 


EXT 


227 


A.P 


MACDONALD 


1313 LEMONTREE 


EXT- 


5 339 


END OF FILE 


?? addln 00010 


END "F FILE 

?? p*(D 

r\ r\ r\ 1 r\ w m- t t\ »rn 

uuuiu n . 1 . ouNi 



ST ZIP CODE 55722 



ZIP 55713 



AVE ZIP 55722 



10© 



(l) The user lists a file in which the first character of 
each file line is a blank. 



(D User inserts a set of line numbers beginning with 

00010 and incrementing by 10. 
(3) User then lists the file to check the effect of the 

ADDLN command. 



00020 1544 WILSHIRE ST ZIP CODE 55722 

00030 EXT 6533 

00040 A.B. NEWTON 

00050 166 HASKELL CIRCLE ZIP 55713 

00060 EXT 227 

00070 A.P. MACDONALD 

00080 1313 LFMONTREE AVF ZIP 55722 

000Q0 EXT 5339 

END OF FILE 



Figure 7-1. The ADDLN Command 
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ADDLNS COMMAND 



DELETING LINE NUMBERS 



When the user wants to add both a line number and a 
trailing blank space to each line in a file, he enters an 
ADDLNS command in one of the following formats: 

ADDLNS In n @ 

ALNS In n @ 

In Line number to be inserted before the first 
line in the file. No line number can exceed 
99999. The default is 1. 



The DtiLETELN command enables the user to remove every 
line number from a file. It has no effect on lines without 
line numbers. The formats are: 

DELETELN @ 

DLN @ 

Figure 7-3 shows a use of this command. 



n Number by which each line number is 
incremented. No line number can exceed 
99999. The default is 1. 

Figure 7-2 demonstrates the ADDLNS command. 



REPLACING LINE NUMBERS 

When the user wants to replace an existing set of line 
numbers with a different set of line numbers, he enters a 
REPLACELN command in one of the following formats. 



??_p*®__ 

Q.S. SMITH 

18 PARK PLACE APT 111 ZIP 55704 

EXT 8866 

P.T. BEE 

H710 14TH ST ZIP 55713 

EXT 18 

END OF FILE 

?? addlns 00200 10(2) 

EN^ OF FILE 

?? p*(D 

00200 Q.E. SMITH 

00210 18 PARK- PLACE APT 111 ZIP 55704 

00220 EXT 8866 

00230 P.T. BEE 

00240 8710 14TH ST ZIP 55713 

00250 EXT 18 

END, OF FILE 

99 



(T) The user lists a file in which 
left-justified. 



. (2) User inserts a set of line numbers beginning with 

00200 and incremented by 10, 
(D User then lists the file to check the effect of the 

ADDLNS command. 



Figure 7-2. The ADDLNS Command 



?? D*© 

00200 Q.E. SMITH 

00210 18 PARK PLACE APT 111 ZIP 55704 

00220 EXT 8866 

00230 P.T. BEE 

00240 8710 14TH ST ZIP 55713 

00250 EXT 18 

END OF FILE 

?? deletein© 

END OF FILE 

?? p*(D 

O.E. SMITH 

18 PARK PLACE 

EXT 8866 

P.T. BEE 

8710 1*1 TF ST ZIP 55713 

EXT 18 

END OF FILE 
99 



® The user lists a file with line numbers. 



APT 111 ZIP 55704 



(D User deletes every line number in the file. 

® User then lists the file to check the effect of the 
DELETELN command. 



Figure 7-3. The DELETELN Command 
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REPLACELN In n 3 
RLN In n @ 

In Line number to replace the first line number in 
the file- No line number can exceed 99999. 
The default is 1. 

n Number by which each line number is 
incremented. No line number can exceed 
99999. The default is 1. 

The REPLACELN command shown in figure 7-4 only 
changes a line if it is preceded by a line number. 



FINDING LINES WITHOUT LINE NUMBERS 

When a user wants to locate a specific . number of lines 
without line numbers, he enters a FBADL command. This 
command is a mnemonic for find bad lines, bad lines being 



lines without line numbers. This command should be used 
in verify mode so that the lines located are printed. Its 
formats are: 

FBADL n @ 

FBLn @ 

n Number of lines without line numbers that the 
user wants to locate. The maximum value is 
99999; the default is 1. The file pointer is 
positioned at the last line located unless the 
end-of-information mark is read. If n is *, 
XEDIT locates all lines not preceded by a line 
number from the current pointer position to 
the end-of-information or until 99999 lines 
have been located. If n is 0, XEDIT positions 
the pointer at the first line located. 

Figure 7-5 demonstrates the FBADL command. 



. SMITH 

PARK PLACE APT 111 ZIP 55704 



?? p*® 
00100 0.E 
00110 18 
00120 EXT" 8866 
00 HO P.T'. BEE 

00140 8710 14TH ST ZIP 55713 
00150 EXT 18 
'END OF FILE 
?? replaceln 00500 
END OF FILE 



(T) The user lists a file with line numbers. 



5© 



i® 



00500 O.E. SMITH 

00505 18 PARK PLACE APT 111 ZIP 55704 

00510 EXT 8866 

00515 P.T. BEE 

00520 8710 14TH ST ZIP 55713 

00525 EXT" 18 

END OF FILE 



® User issues a REPLACELN command specifying 
that the first line number should be 00500 and the 
line numbers should be incremented by 5. 

® User lists the file to check the results of the 
REPLACELN command. 



Figure 7-4. The REPLACELN Command 



?? too 

?? fbadl*® 

### NAMES /ADDRESSES ARE FICTITIOUS ###@ 
END OF FILE 

99 



® The user issues a FBADL command to find all lines 
without line numbers in the file. 

® Because it is in verify mode, XEDIT prints the line 
found. It also prints the END OF FILE message to 
indicate that the entire file was searched. 



Figure 7-5. The FBADL Command 
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DELETING LINES WITHOUT LINE NUMBERS 



DBADL n @ 



The user can delete lines which do not begin with a line 
number by entering a DBADL command. Starting at the 
current pointer position, XEDIT locates and deletes the 
number of lines without line numbers specified in the 
command. When XEDIT operates in verify mode, the editor 
lists each line that is deleted. The formats are: 



UDb n <£R) 



Number of lines which the user wants deleted 
starting at the current pointer position. The 
maximum value is 99999; the default value is 
1. If n is *, XEDIT deletes aU lines without 
line numbers from the current pointer position 
to the end-of-information or until 99999 lines 
have been deleted. If n is 0, the next line 
without a line number is deleted. 



This command is used in figure 7-6. 



?? dbadl*© 

### NAMES/ADDRESSES ARE FICTITIOUS ### 

END OF FILE© 



The user issues a DBADL command to delete all 

lines without line numbers. 
© XEDIT prints the line it deleted and the END OF 

FILE message indicating that the entire file was 

searched. 



Figure 7-6. The DBADL Command 
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MISCELLANEOUS EDITING COMMANDS 



8 



The following XEDIT commands perform various editing 
functions. 



Command Description 



DLBLANKS Deletes leading blanks from file lines. 

TOPNULL Inserts a blank line at the beginning 

of- the file . 

OCTCHANGE Converts display code strings. 

RESTORE Cancels the effect of the most recent 

editing commands. 

DEOF Deletes end-of-file marks from the 

file. 

DEOR Deletes end-of-record marks from 

the file. 

WEOF Writes end-of-file marks onto the file. 

WEOR Writes end-of-record marks onto the 

file. 



DELETING LEADING BLANKS 

The DLBLANKS command deletes leading blanks from a 
specified number of lines in the file between the current 
pointer position and the end-of-information. Blank lines 
are deleted completely. The formats are: 

DLBLANKS n % 

DLB n @ 

n Number of lines from which leading blanks are 
to be deleted starting at the current pointer 
position. The maximum value is 99999; the 
default value is 1. If n is *, XEDIT deletes all 
leading blanks in lines from the current pointer 
position to the end-of-information or until 
99999 lines have been processed. If n is 0, 
XEDIT deletes leading blanks from the current 
line. 

Figure 8-1 uses the DLBLANKS command. 

INSERTING A BLANK LINE AT THE TOP 
OF A FILE 

If the user wants to delete a record mark that begins a file, 
he must insert a blank line in front of the record mark 



?? p*© 


© 


The user lists the file. 


### NAMES/ADDRESSES ARE FICTITIOUS ### 






Q.E. SMITH 






18 PARK PLACE APT 111 ZIP 55704 






EXT 8866 






P.T". BEE 






8710 14T TT ST ZIP 55713 






EXT 18 






END OF FILE 






?? dlblanks*© 


® 


The user deletes all leading blanks from the file 


END OF FILE 




and lists it again for verification. 


?? p* 






### NAMES/ ADDRESSES ARE FICTITIOUS ### 






O.E. SMITH 






18 PARK PLACE APT 111 ZIP 55704 






EXT 8866 




. 


P.T. BEE 






8710 14TH ST ZIP 55713 






EXT 18 






END OF FILE 






?? 







Figure 8-1. The DLBLANKS Command 
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before he can delete it. This is done using the TOPNULL 
command. Its formats are: 

TOPNULL @ 

TN @) 

Figure 8-2 shows an example of use of this command. 

CONVERTING OCTAL STRINGS 

The OCTCHANGE command is used to replace one string 
of octal code (internal display code) with another string of 
octal code. The complete command must be no longer than 
the line length. With this command the user is able to 
enter certain terminal line controls (for example, line feeds 
and carriage returns) into the file that otherwise cannot be 
specified. Refer to the character set tables in the NOS 
Reference Manual Volume 1 for a list of valid display codes 
and their graphic equivalents. The formats are: 

OCTCHANGE octl oct2 n 

OC octl oct2 n 

octl Octal display code that represents the 
existing string to be replaced within the 
user file. Each display code character 
must be represented by an even number of 
octal digits. 

oct2 Octal display code that represents the 
string that replaces octl. Each display 
code character must be represented by an 
even number of octal digits. 
Unpredictable results occur when 
characters are changed to 00 codes. 



Number of lines to be processed by the 






the 



le maximum vaiue is 3a9»9; 
is I. If n is *, XEDIT 



processes every line from the current 
pointer position to the end-of-information 
or until 99999 lines have been processed. 
If XEDIT reads an end-of-information 
mark, the pointer is positioned at the 
beginning of the file; otherwise, XEDIT 
positions it at the last line processed. If n 
is 0, XEDIT processes only the current 
line. 

Figure 8-3 demonstrates the OCTCHANGE command. 



CANCELING EDITING OPERATIONS 

The user issues a RESTORE command to cancel all editing 
operations performed since the pointer was positioned at 
the beginning of the file. This command is entered when 
the user determines that one or more recently issued 
commands were incorrectly entered or did not accomplish 
what the user originally intended. Changes made before 
the following events cannot be restored. 

• An END OF FILE message is printed. 

• A TOP command is processed. 

• An up-arrow ( f ) command prefix is processed. 

• A NEXT -n command is processed. 



A find line number (In) command is processed 
causing a circular search. 

A FILE command is processed. 



■® 

00© 



xedit ,bpgm 
XEDIT 3. 1. 
— EOR— 
— EOR-- 
?? print*© 

00200 PRINT "SCR EXAMPLE" 
00210 INPUT N 
00220 PRINT SOR(N) 
00230 END 
END OF FILE 
-_S()R— © 
—EOR— 
?? topnull© 
??" xdeor 2 © 
?? tdelete _ 
?? print* © 
00200 PRINT "S0R EXAMPLE" 
00210 INPUT N 
00220 PRINT SQR(N) 
00230 END 
END OF FILE 

99 



© The user calls XEDIT to edit a file called BPGM. 

© XEDIT prints its header and two end-of-record marks before positioning the 
pointer at the first line in the file. 

© The user lists the file. 



® After reading the end-of-information mark, XEDIT reads the two 
end-of-record marks before positioning the pointer at the first line of the 
file. 

The user inserts a blank line at the beginning of the file. 
User deletes the two record marks without verification, then deletes the 
blank line user had inserted. 
User lists the file again. 



Figure 8-2. The TOPNULL Command 
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ascii (T) 




© 


The user enters ASCII mode in order to use the full character set. 


READY." 








xedit ,pass,c (2) 




® 


The user calls XEDIT to create a file called pass. 


XEDIT 3. 1.00 








??(D 




® 


User enters input mode and inserts two lines into the file. 


INPUT 








? today.' s password is: 






? orange 

9 








EDIT 








?? ~print*(4) 




® 


User lists the file and then positions the pointer at the second line. 


today.' s password is: 








orange 








END OF FILE 








?? next 








orange 








?? xadd© 




© 


A string of characters is appended to the end of the line. 


? $$wwwwww$$mmmmmm 








?? ~print*© 




© 


The edited file is printed. 


today's password is: 








orange$$wwwwww$$mmmmmm 






END OF FILE 


© 






?? octchange 53 7655 


© 


The user next issues an OCTCHANGE command to replace each 


mHHfflgS© 

?■? "print*© 






dollar sign (octal code 53) with a carriage return (octal code 7655). 




® 


XEDIT verifies the effect of the OCTCHANGE command. 


today's password is: 




® 


The user lists the file again. 


fflBHBrgffl 








END OF FILE 








?? 









Figure 8-3. The OCTCHANGE Command 



The formats are: 

RESTORE @ 

REST @ 
Figure 8-4 uses the RESTORE command. 

DELETING AND INSERTING RECORDS 
AND FILE MARKS 



The user can both insert and delete record and file marks. 
DEOR and DEOF commands enable the user to delete these 
marks, while WEOR and WEOF commands allow the user to 
insert them. 



DEOR COMMAND 

The DEOR command deletes a specified number of 
end-of-record marks- from the file. The formats are: 

DEOR m © 

DR m @ 

m Number of end-of-record marks to be deleted 
starting at the current pointer position. The 
maximum value is 99999; the default value is 
1. If m is *, XEDIT deletes all 
end-of-information or until 99999 

end-of-record marks have been deleted. If m 
is 0, the next end-of-record mark is deleted. 

Figure 8-5 shows use of the DEOR command. 



""- 1 x - t v£/ 



?? xlocate/smith/® 

?? delete 3 © 

00160 O.E 

00170 322 WILSHIRE ST ZIP CODE 55723 

00180 EXT 67 

?? restore(4) 

?? 160© ^ 

00160 O.E . SMITH 



© The user sets the pointer to the first line containing 

the string SMITH. 
(2) User then deletes three lines. 
© XEDIT verifies the lines deleted. 

© Seeing that user deleted information on the wrong 

SMITH, the user issues a RESTORE command. 
© To verify the restoration, the user locates line 160. 



Figure 8-4. The RESTORE Command 
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?? p»® 


© 


The user lists the file. 


1 00190 P.T. BEE 






1 00200 8710 14TH ST ZIP 55713 






--EOR— 






| — EOR-- 






00210 EXT 18 






### EXECUTIVE LISTING ### 






END OF FILE 






?? deor*© 


(2) 


The user deletes the end-of-reeord marks. 


--EOR-- 




XEDIT verifies that two end-of-reeord marks were found in 


— EOR-- 




the file and deleted. 


END OF FILE 






?? 







Figure 8-5. The DEOR Command 



?? p»® 


d) 


The user lists the file. 


00190 P.T. BEE 






00200 8710 14TH ST ZIP 5571 ^ 






— EOR — 






— EOF — 






210 EXT 18 






### EXECUTIVE LISTING ### 






END OF FILE 






?? deof*© 


(2) 


User deletes all end-of-file marks in the file. 


— EOR— 






—EOF— 






END OF FILE 






?? 







Figure 8-6. The DEOF Command 



?? locate/executive/® © 

### EXECUTIVE LISTING *## 
?? weor © (2) 

?? to*© W 

00190 P.T. BEE © 

00210 EXT 18 

— EOR— 

### EXECUTIVE LISTING ### 

END OF FILE 



The file pointer is positioned at the line containing the word 

EXECUTIVE. 

The user issues a WEOR command to insert an end-of-record mark 

before that line. 

The user lists the file. 



Figure 8-7. The WEOR Command 



DEOF COMMAND 

The DEOF command deletes a specified number of 
end-of-file marks from the file. Its formats are: 

DEOF m @ 

DF m @ 

m Number of end-of-file marks to be deleted 
starting at the current pointer position. The 
maximum value is 99999; the default value is 
1. If m is *, XEDIT deletes all end-of-file 
marks from the current pointer position to the 
end-of-information or until 99999 end-of-file 
marks have been deleted. If m is 0, the next 
end-of-file mark is deleted. 

The DEOF command is used in figure 8-5. 



NOTE 



The DEOF command deletes only 
end-of-file marks. It does not delete 
end-of-record marks (such as those 
created by the WEOF command). 



WEOR COMMAND 

To insert an end-of-record mark into the file in front of the 
current pointer position, the user enters a WEOR command 
in one of the following formats: 

WEOR @ 

WR @ 

Figure 8-7 demonstrates the WEOR command. 
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WEOF COMMAND 

To insert an end-of-file mark into the file in front of the 
current pointer position, the user enters a WEOF command 
in one of the following formats: 

WEOF @ 

WF @ 



Figure 8-8 shows the WEOF command. 



NOTE 



The system inserts an end-of-record mark 
before the end-of-file mark if one does 
not already exist. 



?? locate/executive/© 


® 


The file pointer is positioned at the line containing the word 


### EXECUTIVE LISTING ### 




EXECUTIVE. 


?? weof® 


© 


The user issues a WEOF command to insert an end-of-file 


?? tlocate/bee/ 




mark before that line. 


00190 P.T. BEE 






?? p*© 


© 


The user lists the file. 


00190 P.T. BEE 






00200 8710 14TH ST ZIP 55713 






00210 EXT 18 






— EOR— 






— EOF— 






### EXECUTIVE LISTING ### 






END OF FILE 






?? 







Figure 8-8. The WEOF Command 
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MANIPULATING FILES 



The user can manipulate files during editing with the 
following XEDIT commands. 

Command Description 

COPY Copies a specified set of lines from the 

edit file onto another file. 

COPYD Copies a specified set of lines from the 

edit file onto another file and deletes 
those lines from the edit file. 

READ Copies the contents of the specified local 

files onto the edit file. 

READP Copies the contents of the specified 

permanent files onto the edit file. 

FILE Saves an intermediate version of the edit 

file. 



COPYING LINES ONTO ANOTHER FILE 

When the user wants to copy lines from the edit file onto 
another local file, he can enter either a COPY or a COPYD 
command. Both commands perform the same function, 
except that the copied lines are deleted from the edit file 
when the COPYD cqpmand is used. The following rules 
apply to both COPY and COPYD. commands. 

• Copying begins at the current pointer position and 
includes all lines in the file from the current 
pointer position through the line containing the nth 
occurrence of the specified string. If XEDIT reads 
the end-of-information mark while processing these 
commands, all lines in the file between the initial 
pointer position and the end-of-information are 
copied to the local file. 

• After the copying is completed, the pointer is 
positioned at the last line copied or at the 
beginning of the file if the end-of-information is 
read. 

• When verify mode is in effect, XEDIT prints only 
those lines containing the specified string. 

• Before copying begins, XEDIT rewinds the local 
file. Later copies onto the same file are added to 
the end of that file. 

• To specify what columns the specified string should 
occur in, the windowing feature can be used with 
the COPY and COPYD commands. (Refer to the 
W MARGIN command.) 

The following are the formats of the COPY command and 
their functions. 



COPY fname n © 

Copies n lines from the edit file onto file fname. 

COPY fname /string/n @ 

Copies onto file fname all lines from the current 
pointer position through the nth line containing the 
specified string or until the end-of-information 
mark is read. 

COPY fname /stringl...string2/n @ 

Copies onto file fname all lines from the current 
pointer position through the nth line containing 
stringl followed by string2 or until the 
end-of-information mark is read. 

COPY fname /stringl — string2/n @ 

Copies onto file fname all lines from the current 
pointer position through the nth line containing 
stringl not followed by string2 or until the 
end-of-information mark is read. 

COPY fname / — string2/n @ 

Copies onto file fname all lines from the current 
pointer position through the nth line not containing 
string2 or until the end-of-information mark is read. 

fname Name of the file onto which the 
specified lines are to be copied; the 
file name can be from one to seven 
alphanumeric characters. If fname is 
OUTPUT, the specified lines are 
copied to file OUTPUT. At least one 
blank must appear before and after 
fname. 

n Number of lines to be copied or the 

number of lines containing the 
specified string that are to be located 
before the copying is completed. The 
maximum value is 99999; the default 
value is 1. If n is *, XEDIT copies all 
lines from the current pointer 
position to the end-of-information or 
until 99999 lines have been copied. If 
n is 0, a string is specified, and it is 
the first copy to the specified local 
file; the file is rewound, the pointer 
is not advanced, and the current line 
is copied if it contains the specified 
string. 

string Specified string of alphanumeric 
characters to be located. 
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?? locate/*division/© 
•DIVISION 1* 

W 



*g\Tn (if nT7 T t;TfH]* 

99 



end , , rl(3) 
DIV REPLACED 
DIV IS A LOCAL FILE 
/lnh,f=div1@ 
•DIVISION 1* 
00130 A.B. NEWT'QN 

00140 166 HASKELL CIRCLE ZIP 55713 
00150 EXT 227 

00157 A. P. MACDONALD 

00158 1313 LEMONTBEE AVE ZIP 55722 

00159 EXT 5339 
00l Sn O.E. SMITH 

00170 18 PARK PLACE APT 111 ZIP 55704 
00180 EXT 8866 
*END OF DIVISION* 
/ 



The user locates the string *DIVISION. 






© 

© 



me user curies an unes irom tne current pointer 
position until the next line containing the string *END 
onto the local file DIV1. 
The user terminates XEDIT execution. 

The user lists the local file DIV1. 



Figure 9-1. The COPY Command 



Figure 9-1 uses the second format of the COPY command. 

The COP YD command uses the same parameters as the 
COPY command. It aiso is processed the same as the 
COPY command except that the copied lines are deleted 
from the edited file. The formats are: 

COPYD fname n @ 

or 
COPYD fname /string/n @ 

or 
COPYD fname /stringl...string2/n @ 

or 
COPYD fname /string! — string2/n % : 

or 

COPYD fname / — string2/n @) 

When the user enters the COPYD command with fname 
specified as NULL, XEDIT deletes the lines without saving 
them on a local file. 

MERGING FILES INTO THE EDITED FILE 

To merge one or more files into the edited file, the user 
enters a READ or READP command. While both commands 
function the same, READ commands copy local files, and 
READP commands copy permanent files. The following 
general rules govern use of both READ and READP 
commands. 

• The specified local or permanent file is copied onto 
the edited file after the current pointer position, 
starting with the first record, and continuing until 
two consecutive end-of-record marks, an 
end-of-file mark, or an end-of-information mark is 
detected. Embedded end-of-record marks are 
maintained. 



• Once each copying operation is completed, the 
pointer is positioned at the last line that was 
copied onto the edited file. 

• XEDIT rewinds the specified files before and after 
the copying operation. 

• If a specified local or permanent file cannot be 
read (for example, it does not exist or the user 
entered the wrong file name), XEDIT prints an 
error message and ends processing of the READ or 
READP command without copying any other files. 

The format of the READP command is: 

READP fnamei fname2...fname n @ 

fnamej Names of the files to be copied onto 

the edited file in the sequential order 
in which they are to be copied. A 
space must separate each name from 
the preceding name. 

This format is used in figure 9-2. 

The READ command uses the same format and parameters 
as the READP command. It copies specified local files 
onto the edit file. To move a group of lines from one part 
of the file to another, the user can copy the lines onto a 
local file using the COPY or COPYD commands and then 
insert the lines at the desired location by positioning the 
pointer and entering a READ command to copy the local 
file onto the edit file. The format of the READ command 



READ fnamej fname 2 ...fname n @) 



SAVING AN INTERMEDIATE XEDIT FILE 

The FILE command enables the user to save an 
intermediate version of the edit file. When the FILE 
command is entered, the following procedure occurs. 

1. XEDIT saves a copy of the edit file as specified by 
the mode parameter. 



9-2 



60455730 B 



•® 



MANAGEMENT* 
KRAMER HQR2ii130 



?? 

•EXECUTIVE 

00100 A.B 

00110 J.J 

00120 B.C 

END OF FILE 

?? 120(f) 

00120 B.C. MILLER HQR44120 



JOHNSON 

MILLER 



SWP19130 
HOR44120 



readp divml 
Tprint*® 



id1© 



?? 
?? 

•EXECUTIVE "MANAGEMENT* 
00100 A.B. KRAMER HQR24130 
00110 J.J. JOHNSON SWP19130 
00120 B.C. MILLER H0R44120 
•DIVISIONAL MANAGEMENT— PRT" DIVISION* 



(T) The user lists the file. 



(2) The user positions the pointer at line 120. 

(D The user copies the files DIVM1 and RAD1 onto the 

edit file. 
(4) The user lists the edit file. 



00100 F.R. OLSON 


RPT01 


00110 M.L. MORRIS 


RPT23 


00120 B.V. ELLIOT 


RPT24 


00130 T'.C. ROWE 


RPT24 


00140 H.K. MCGUIRE 


RPT89 


•RPT RESEARCH AND DEVELOPMENT* 


00100 E .R. STANLEY 


RPT 55 


00110 R.V. HOIM 


RPT 56 


00120 W.D. ALTHOLZ 


RPT 57 


00130 K.B-: BELLMON 


RPT 58 


END OF FILE 




?? 





Figure 9-2. The READP Command 



2. XEDIT prints one or more messages verifying its 
action. 

3. XEDIT positions the pointer at the beginning of the 
file. 

4. XEDIT requests the next editing command. 
The formats for the FILE' command are: 

FILE, fname, mode @ 

F,fname,mode @ 

fname Name to be given to the copy of the edit 
file; it can be from one to seven 
alphanumeric characters in length. If 
fname is omitted, the file is given the 
name given the edit file when XEDIT was 
called. The commas before and after 
fname must be included although fname is 
omitted (for example, FILE„SAVE). 

mode Type of NOS file to be created. The 
possible modes and descriptions are: 

S or SAVE 

Saves the edit file as a new 
indirect access permanent file. 



R or REPLACE 

Replaces the existing indirect 
access file fname with the edit 
file (same as SAVE if no file with 
that name exists). 

L or LOCAL 

Makes the edit file a : temporary 
file; LOCAL mode is .illegal for 
direct access files. 

C or COPY 

Copies the edit file to file 
fname. COPY mode is default 
for direct access files attached 
in write mode. 



RL 



SL 



Combines the functions 
REPLACE and LOCAL modes. 



of 



Combines the functions of SAVE 
and LOCAL modes. 

If the mode parameter is omitted, LOCAL 
mode is assumed for temporary files and 
COPY mode for direct access files. 
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Figure 9-3 demonstrates the FILE command. 



?? 120(T) Q The user positions the pointer at line 120. 

00120 EXT 653? 

?? chanee/6513/6555/© ® The user changes the extension number. 
00120 EXT 6555 

!nnp^'a^rf^ r ® ® The user replaces the indirect access permanent file called ADDRESS with 

ADDRESS REPLACED a copy of the edited file. 

9 9 



Figure 9-3. The FILE Command 
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The commands described in this section enable the user to 
repeat a sequence of editing operations at specified points 
in the file. 



SUBMITTING MULTIPLE ENTRIES IN A 
SINGLE LINE 

The user can issue more than one command in a single line 
by using either of the following methods. 

• By specifying with a DELIMIT command the 
delimiter character to be used to separate a 
sequence of commands and editing data entered on 
a single line. 

• By using the Z or Y command formats to enter 
several commands and their editing data on the 
same line. The command sequence can be repeated 
using the -n command. 



USING DELIMIT COMMAND 

The following are basic rules governing use of the DELIMIT 
command and subsequent delimited sequences. 

• Any valid command can appear within the line of 
delimited commands and editing data. 

• The delimiter specified in the DELIMIT command is 
used to separate commands and editing data. 

• The delimit character specified in the DELIMIT 
command remains in effect until another DELIMIT 
command is issued. 

• The delimiter used in a Y or Z command must not 
be the same character as the delimiter specified by 
the last DELIMIT command. 

• Both commands and editing data (for example, 
input related to an ADD command) can appear 
within a delimited command sequence. To include 
editing data for a command on the same line as the 
command, the user should prefix the command with 
a +. Otherwise, editing data is requested as needed 
via a single question mark prompt. 

DELIMIT commands should be in one of the following 

formats: 

DELIMIT char @ 

DEL char @) 

char Character to be used as the delimiter; it 
must not be alphabetic or a space. In IAF 
if the user wishes to enter the cancel line 
character, it must be followed by a 
space. To specify a comma as a 



delimiter, the command DELIMIT,, is 
entered. If the user omits the character 
from the command, XEDIT clears the 
effect of the previous DELIMIT command. 

Assuming that the last DELIMIT command specified a 
semicolon as the delimiter, a delimited command sequence 
should use the following format. 

cmdi;cmd2;...;emd n 

cmd A legal command (or editing data required 
by a + prefixed command). Each 
command is processed in order from left 
to right. The DELIMIT character must 
not be included in cmd. 

If any command is in error, all remaining commands in the 
list are ignored and the editor requests the next command. 

XEDIT expects editing data as the next delimited item 
following a + prefixed command. Otherwise, editing data is 
requested as needed via a single question mark prompt. 

Figure 10-1 demonstrates the DELIMIT command. 



USING Y AND Z COMMANDS 

The Y and Z commands can be used to enter a deliri ;-id 
sequence of commands and editing data on a single line. 
The only difference in the Y and the Z command operation 
is that "for the[ Z command, XEDIT prints the component 
commands of the sequence as they are processed, and for 
the Y command, it does not print them. 

The following basic rules apply to both Y and Z commands. 

• Any valid XEDIT command except Y and Z 
commands can be included in the list of component 
commands. The Y or Z command delimiter should 
never be the same as the delimiter specified by the 
last DELIMIT command. If a DELIMIT command is 
included in a Y or Z command, the DELIMIT 
character takes effect only after XEDIT has 
processed all component commands in the Y or Z 
command sequence. 

• If any command in the sequence is in error, all 
remaining commands in the sequence are ignored, 
and XEDIT requests the next command. 

• Both commands and editing data can appear as part 
of the command sequence. XEDIT expects editing 
data as the next delimited item following a + 
prefixed command. 

• The command delimiter for the Y and Z commands 
can be any alphnumeric or special character not 
appearing within a component command or editing 
data item and which is not the delimiter character 
specified in the last DELIMIT command. 
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The user lists two lines. 



?? orint 2© 
00220 P.B. COLLINS 
002 30 710 ELM ST 

?? +xaf I zi D 5: 55722& + i&00240 ext 7?*A??nn^ rtl The user sets the delimiter character as &. 

00220 P b COLLTNS 726&220p3(3) © The user enters a delimited command sequence 

00230 710 ELM ST ZIP 55722 containing: 



00240 EXT 726 
99 



An abbreviated + and x prefixed ADD 
command. 

The string to be appended by the ADD 
command. 

An abbreviated + prefixed INSERT 
command. 

The line to be inserted. 

An abbreviated PRINT command to list 
three lines beginning at line 220. 



Figure 10-1. The DELIMIT Command 



It is suggestea that dollar signs or semicolons be used as 
command delimiters and slashes as string delimiters 
because those characters are never found in XEDIT 
commands. 

Since the character for the DELIMIT command and the 
delimiter in the Y or Z command cannot be the same the 
user might enter DELIMIT ; and then choose the $ for his 
delimiter in the Y or Z command. The formats are as 
follows: 

Y$cmd 1 Scmd 2 $...$cmd n @ 

or 

Z$cmd 1 $cmd 2 $...$cmd n @ 

$ Command delimiter. 



cmd 



A legal command (or editing data required 
by a + prefixed command). Each 
command is processed in order from left 
to right. The command delimiter must 
not be included in cmd. 



A Z command is used in figure 10-2. 



REPFATiKirs rr\KAKA AKir\c 

The user can repeat the processing of the preceding 
command at a different pointer position. To do so he 
enters a period followed by the number of lines the pointer 
should be advanced before the preceding command is 
processed again. To repeat the processing of a Y or Z 
command, the user enters a minus sign followed by the 
number of lines the pointer should be advanced. The 
formats are: 

.n @ 

or 

-n @ 

Process the preceding command (other than Y 
or Z commands). 

Process the preceding Z or Y command. 

n Number of lines that the pointer should be 
advanced before processing the preceding 
command. The default value is 1. If n is 0, 
the last command is processed without 
advancing the pointer. 

Figure 10-3 shows how to repeat a command. 

Figure 10-4 uses a delimited command sequence and the 
repeat command. 



?? z$locate/smith/$+add$ ir 3delpi-p/hoo/(T) /T\ ^ u 

?? LOCATE/SMITH/ (2) J 1 *- ^elete/bee/U) © The user enters a Z command containing three 

00160 O.E. SMITH component commands: LOCATE, ^DD 

99 +ADD _ DELETE. 

00 160 O.E. SMITH JR ® XEDIT prints each processed comi 

?? DFLETE/BEE/ '" verification of its action. 

00190 P.T. BEE 



and 



imand and 



Figure 10-2. The Z Command 
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?? print® 


® 


The user prints a line. 


001^0 A. 3. MACDONALD 






?? .3© 


© 


The user enters a .3 to advance the pointer three lines and 


00157 A. P. MACDONALD 




print that line. 


?? .3® 


© 


The user once again advances the pointer three lines and 


00180 EXT" 67 




prints the line. 


?? 







Figure 10-3. Repeating a Command 



, s-^ 




/--\ 






?? del %Kl) 






The user sets the delimiter as $. 




?? l/address/$+insert$zip 


code:© 


© 


The user enters a delimited command sequence 


containing 


ADDRESS: -. 






two commands, LOCATE and INSERT. 




?? T D rint*(3) 




© 


The user lists the file. 




NAME : 










ADDRESS: 






1 




ZIP CODE: 










END OF FILE 










?? add$.*.$.@ 

? a.e. smith jr.© 




© 


The user then enters a delimited command 


sequence 






consisting of the ADD command processed four 


times on 


NAME: Q.E . SMITH JR. 






consecutive lines. 




? pob 55 




© 


For each prompt, the user enters an appropriate 


string and 


ADDRESS: POB 55 






XEDIT prints the appended line. 




? 55703 










ZIP CODE: 55703 










END OF FILE 










?? 











Figure 10-4. Repeating a Command Sequence 
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The commands in this section provide valuable formatting 
tools for the user. Tab control commands ensure proper 
spacing of paragraphs, tables, and programs. Margin 
control commands enable the user to set a right margin, 
locate lines that extend beyond that margin, and truncate 
them. 



TAB CONTROL 

The user can control tab settings during editing by 
employing the following XEDIT commands. 

Command Description 

DEFTAB Defines a tab character for use in 

entering editing data with the INSERT, 

INSERTB, REPLACE, INPUT, and © 
commands. 

TABS Defines tab stop positions. 

LISTAB Lists the current tab character and tab 

stop position. 



DEFINING TAB CHARACTER 

The user can define a tab character by issuing a DEFTAB 
command in one of the following formats: 

DEFTAB char © 



DT char <cfc) 



char 



The tab character to be used in entering 
editing data with the INSERT, INSERTB, 
REPLACE, INPUT, and © commands. 
If the user issues a DEFTAB command 
without specifying a tab character, XEDIT 
clears the effect of the previous DEFTAB 
command. There is no default tab 
character. If the cancel line character is 
specified by IAF users, it must be 
followed by a space. To specify a comma 
as the tab character, the user must enter 
DEFTAB,,. 



Figure 11-1 demonstrates lab character definition and use. 



DEFINING TAB POSITIONS 

The user can define up to eight tab column positions by 
issuing a TABS command in one of the following formats: 



TABS t x t 2 t 3 ...t 8 © 
TAB t t t2 t 3 ...t 8 © 



t Tab column positions with increasing values 
from left to right; default values are 11, 18, 
and 30. When a TABS command is entered 
without any t parameters, XEDIT clears the 
effect of the previous TABS command. Any 
tab characters included in the input line 
beyond the last tab stop are copied to the file. 

Figure 11-2 shows the setting of tab stops. 



LISTING TAB SETTINGS 

The user can list the current tab character and tab stop 
column positions by issuing a LISTAB command in one of 
the following formats: 

LISTAB © 

LT © 

Figure 11-3 uses the LISTAB command. 



MARGIN AND TRUNCATION CONTROL 

The following commands can be used to control the length 
of file lines. 

RMARGIN Sets the right margin position. 

FINDLL Finds lines longer than the current right 

margin setting. 

TRUNCATE Truncates lines longer than the current 
right margin setting. 



?? insert 

? $mtd&ytd$total© 



DTI 



nt© 



MTD 



YTD 



TOTAL 



© 
® 



The user issues a DEFTAB command to establish the dollar 

sign ($) as the tab character. 

A line is inserted into the file using the tab character to 

space the column headings according to the default tab 

column positions, 11, 18, and 30. 

The user lists the line for verification. 



Figure 11-1. Defining a Tab Character 
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?? 


deftab;© 


?? 


tabs 5 10 15 20 


?? 


Insert 7 (?) 


9 


i. statistics 


9 


"a. probability 


? 


b. expected value 




; 1 . average 


? 

• 


;2. variance 


9 

■ 


;^. standard deviation 


9 

• 


c. regression theory 


99 


Tl/stat/© 


I. 


STATISTICS 


99 


P* 


I. 


STATISTICS 




A. PROBABILITY 




B. EXPECTED VALUE 




1. AVERAGE 




2. VARIANCE 




3. STANDARD DEVIATION 




C. REGRESSION THEORY 


end 


OF FILE 


99 





The user establishes the semicolon as the tab character and 
sets the tab column ^os' + ' rtr,c ' 

y^iy x..^, -Sv., niigi lb OCVCH 111163. 



j. v , x j, euiu iu. 



(|) The user then locates the beginning of the group of lines and 
prints them out as verification. 



Figure 11-2. Defining Tab Stops 



?? deftab;© 
?? tabs 4 8 12 
?? listab© 

; TABS a 8 

99 



CD The user establishes the semicolon as the tab character and sets the 

tab column positions at 4, 8, and 12. 
(D The user then lists the tab character and settings with the LISTAB 

command. 



Figure 11-3. Listing the Tab Settings 



The user can employ these commands to ensure that no file 
lines are longer than 150 characters, the maximum length 
allowed by most NOS line processing routines. 



SETTING THE MARGIN 

The RMARGIN command sets the column position of the 
right margin of a file. Lines extending beyond that column 
can then be located by the FINDLL command and truncated 
by the TRUNC command. After the RMARGIN command 
is executed, the pointer retains its original position. 



RMARGIN m @ 
R\T m @) 



m The column position of the right margin of the 
file. It cannot be less than 10. 



FINDING LONG LINES 

To locate a specific number of long lines, the user issues a 
FINDLL command. Long lines are lines longer than the 
current right margin setting (refer to the RMARGIN 
command). This command should be entered while editing 
in verify mode so that the located long lines are "listed. 
The formats for the FINDLL command are: 

FINDLL n @ . 

FLL n @) 

n Number of lines longer than the current 
RMARGIN setting to be located. The 
maximum value is 99999; the default value is 
1. If n is *, XEDIT locates all lines from the 
current pointer position to the 

end-of-information or until 99999 occurrences 
are found. The pointer is located at the last 
long line found or at the beginning of the file 
if the end-of-information mark is read. If n is 
0, XEDIT finds the next long line. 
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. . „/T\ 




/Os 




r< pnnt x w 




^ 


The user lists the file. 


•EXECUTIVE MANAGEMENT* 








EX100 «.W. KRAMER 


HOP24 






SX120 J.J. JOHNSON 








EX125 R.E. MILLER 


. HQR44 




. 


EX130 F.R. SCOTT 








END OF FILE 








?? rmarsUn 25© 




© 


The user sets the right margin at column 25 and then lists all 


?? findll* 






lines longer than 25 characters. 


SX100 S.W. KRAMER 


HQR24 






EX125 R.E. MILLER 


HQR44 






END OF FILE 








?? 









Figure 11-4. The RMARGIN and FINDLL Commands 



Figure 11-4 uses both the RMARGIN and the FINDLL 
commands. 



TRUNCATING LONG LINES 

The TRUNCATE command truncates a specified number of 
lines at the right margin set' by the RMARGIN command. 
The formats are: 



TRUNCATE n @ 
TRUNC n @ 



n The number of lines the user wants searched 
for possible truncation. The maximum value is 
99999; the default value is 1. If n is *, XEDIT 
searches all lines from the current pointer 
position to the end-of-information or until 
99999 lines have been searched. The pointer is 
positioned at the last line searched or at the 
beginning of file if the end-of-information 
mark is read. If n is 0, XEDIT searches one 
line for possible truncation. 

Figure 11-5 shows use of this command. 



?? print*® 




© 


! 

The user lists the file. I 


•EXECUTIVE MANAGEMENT* 








EX 100 S.W. KRAMER 


HQR2 4 






FX120 J.J. JOHNSON 








EX125 R.E. MILLER 


HQR44 






EX 130 F.R. SCOTT 








END OF FILE 

?? rmargin 25© 










© 


The user sets the right margin at column 25. 


?? truncate*©- 




© 


The user then truncates all lines in the file longer than 25 


•EXECUTIVE MANAGEMENT* 






characters. 


EX100 S.W. KRAMER 








EX120 J.J. JOHNSON 








EX125 R.E. MILLER 








EX130 F.R. SCOTT 








END OF FILE 








?? 









Figure 11-5. The TRUNCATE Command 
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TERMINATING XEDIT 



12 



The user issues one of the following commands to end his 
editing session. 

END or QUIT Terminates editing and saves the edit 
file. 



STOP 



Terminates editing and does not save 
the edit file. 



TERMINATING XEDIT WITHOUT SAVING 
EDITING CHANGES 

The user issues a STOP command to terminate XEDIT 
without saving the edited version of the file. The file is 
left exactly as it appeared before XEDIT was called into 
execution, assuming that no FILE commands were 
processed during the session. If the STOP command is 
issued in batch mode, the first statement after the EXIT 
control statement is executed; otherwise, the job is 
terminated. 

The STOP command has the following format: 

STOP@ 

Figure 12-1 uses the STOP command. 



TERMINATING XEDIT WITH EDITING 
CHANGES SAVED 



When the user wants to terminate XEDIT execution and 
keep the edited file, he issues a QUIT or END command. 
Both END and QUIT perform exactly the same function and 
use identical parameters. The following general rules apply 
to these commands. 



• When the command is entered, the edit file is 
written onto the specified file fname in accordance 
with the specified mode parameter. XEDIT then 
terminates its execution. 

• The edit file becomes the primary file only if the 
filename specified matches the name of the 
primary file. 

• The user should enter SAVE and REPLACE mode 
parameters with care. SAVE and REPLACE 
parameters do not write the edit file modifications 
onto the existing local version of the file. Only 
permanent files are affected by . SAVE and 
REPLACE parameters. 

The END and QUIT commands should be entered in one of 
the following formats: 

END,fname,mode @ 

E,fname,mode @ 

or 

QUIT.fname.mode @ 

Q,fname,mode gr) 

fname Name (one to seven alphanumeric 
characters in length) to be given the edit 
file upon leaving XEDIT. If no file name 
is entered, XEDIT uses the name specified 
for the edit file when XEDIT was called. 
When fname is omitted, the commas 
before and after fname must be entered. 

mode Type of file the edit file is to become. 
Valid entries for this parameter and their 
descriptions are: 



?? delete 3© 




© 


The user deletes three lines. 


00190 R.C. CARTER 








00200 6100 WILSHIRE ST 


ZIP CODE 55722 






00210 EXT 1 101 








END OF FILE 








?? restore©- 




© 


The user then attempts to restore the deleted lines but 


?? 190 






fails to do so because the end-of-information mark was 


END OF FILE 




© 


read during the deletion. 


?? stop @ 




The user then terminates XEDIT execution to return 


ABORTED 






the file to its original state. 


xedit © 




© 


When user calls XEDIT again, line 190 is included in 


XEDIT 3. 1.00 






the file. 


?? 190 








00190 R.C. CARTER 








?? 









Figure 12-1. The STOP Command 
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S or SAVE 



L or LOCAL 



Saves the edit file as a new 
indirect access permanent file. 

R or REPLACE 

Replaces the existing indirect 
access permanent file fname 
with the edit file. 

C or COPY 

Rewrites the edit file onto the 
direct access file of the same 
name. This mode is default for 
direct access files attached in 
write mode. 



file. The default is LOCAL. 



RL 



SL 



Combines the functions 
REPLACE and LOCAL modes. 



of 



Combines the functions of SAVE 
and LOCAL modes. 

If the mode parameter is omitted, LOCAL 
mode is assumed for temporary files, and 
COPY mode is assumed for direct access 
files. 

Figures 12-2 and 12-3 show use of the END command with 
REPLACE and RL specified, respectively. 



?? 120® 

00120 EXT 6533 

?? change/ext/extension/* ' 

00120 EXTENSION 6533 

00150 EXTENSION 5339 

00180 EXTENSION 67 

00210 EXTENSION 1 101 

END OF FILE 

?? end, ,r(f) 

ADDRESS REPLACED 

/Inn ® 

### NAMES/ADDRESSES ARE FICTITIOUS ### 

00100 M.T. JONES 

00110 1544 WILSHIRE ST ZIP CODE 55722 

00120 EXT 6533 

00130 A.B. MACDONALD 

00140 1313 LEMONTREE AVE ZIP CODE 55722 

00150 EXT 5339 

00160 T.G. SLATER 

00170 322 WILSHIRE ST ZIP CODE 55723 

00 180 EXT 67 

00190 R.C. CARTER 

00200 6100 WILSHIRE ST ZIP CODE 55722 

00210 EXT 1 101 

/ 



(1) Thp user nnsitirwic tha nAin+oi« o+ iin« i on tt 

changes the string EXT to EXTENSION in all lines 
from line 120 to the end-of-information. 



(D The user then terminates XEDIT and replaces the 
indirect access file called ADDRESS with the edit 
file. 

(3) The user then lists the local version of the edit file 
which does not contain the edited changes. 



Figure 12-2. The END Command Using REPLACE Mode 
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?? 1 20 (T) (T) The user positions the pointer at line 120. 

00120 F.XT 653? _ _' . 

?? change/ext/extension/*(2) (2) The user changes the string EXT^to EXTENSION in 

00120' EXTENSION 6533 all lines from 120 to the end-of-information. 

00150 EXTENSION 5339 

00180 EXTENSION 67 

00210 EXTENSION 1101 

™MD OF FILE * 

??»nd,,rl(3) @ The user then terminates XEDIT and replaces both 

ADDRESS 'REPLACED ' tne indirect access permanent file called ADDRESS 

ADDR^S T S A LOC a t FIT ^ and the local file with the edit file. 

/lnh(4) "" © The user lists tne local fiie containin ? the edited 

### NAMES/ADDRESSES ARE FICTITIOUS ### changes. 

00 100 M.T. JOMES 

00110 15^4 WILSHIRE ST ZIP CODE 55722 

00120 FXTENSION 6533 

00 130 A.R. MACDONALD 

ooiijn m3 lfmontree avs zip code b5722 

00150 EXTENSION 5339 

00160 T.G. SLATER 

00170 322 WILSHIRE ST ZIP CODE 55723 

00 180 EX "INTERRUPTED* 



Figure 12-3. The END Command Using RL Mode 
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GLOSSARY 



Alphanumeric 

Consisting of alphabetic and/or numeric characters 
only. 

ASCH Mode 

Use of American National Standard Code for 
Information Interchange; the 128-eharacter set. It 
includes both uppercase and lowercase letters. 



BASIC 



1. Selects BASIC subsystem. 

2. Beginner's all-purpose symbolic instructional 
code is an elementary programming language 
available to the user. 

Batch Job 

Instructions and data submitted as a complete unit 

without further user intervention. The job can be 

punched on cards or created and submitted from a 
terminal. 

Beginning-of-Information (BOI) 

Signifies the beginning of a file. 

Binary File 

Usually a noneditable file containing a precompiled 
program. 

Brief Mode 

XEDIT commands are not verified. When a user enters 
a command the system executes the command but does 
not print the results. 

Command 

A set of characters used to signify a specific set of 
instructions in a time-sharing subsystem. 

Control Statement 

A set of characters used to signify a specific set of 
instructions for a batch job. 

Default Value 

When a user enters a command or control statement 
but omits a parameter XEDIT assigns a predetermined 
value to that parameter. This value is called the 
default value. 



Delimiter 

A character used to define a string or separate 
commands. 

Direct Access File 

A permanent file that can be attached to a user's job. 
All changes to this file are made on the file itself 
rather than a temporary copy of the file. 

Directive 

A set of instructions subordinate to an XEDIT 
command. 

Display Code 

An internal character set used to represent 
alphanumeric and special characters. 

END OF FILE 

A message printed when command processing reaches 
the end of the XEDIT file. 

End-of-File (-EOF-) 

The terminator of a logical file. XEDIT prints -EOF— 
when encountering an EOF. 

End-of-Information (EOI) 

The physical end of a file. XEDIT 'prints the END OF 
FILE message when EOI is encountered. 

End-of-Record (— EOR— ) 

The terminator of a logical record. XEDIT prints 
—EOR— when EOR is encountered. 

Escape Character 

A character defined within the INPUT command 
which, when entered before the EDIT command, allows 
the user to leave input mode. 



File 



A set of information that begins at 

beginning-of-information (BOI) and ends at 

end-of-information (EOI), and is referred to by a local 
file name. 
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FORTRAN 

1. Selects the subsystem which uses the FORTRAN 
Version 5 compiler , 

2. FORmula TRANsiation, a high-level language 
consisting of symbols and statements that can be 
used to create a program closely resembling 
mathematical notation. 

Indirect Access File 

A permanent file that is accessed only bv making a 
temporary copy of the file (GET, OLD, or LIBRARY 
commands). It is created or altered by saving or 
substituting the contents of an existing temporary file 
(REPLACE or SAVE commands). 

Interactive Facility (IAF) 

Software product which allows a time-sharing terminal 
user to enter commands and to communicate with an 
executing program. 

Internal Display Code 



Refer to Display Code. 



Job 

In time-sharing mode a job consists of all computer 
related activity associated with a user from the time 
he logs in to the time he logs off. A batch job consists 
of instructions and data that is submitted as a 
complete unit. 

Local File 

Any file that is currently associated with a job. 
Normal Mode 

Selects the standard (64 or 63) character set where all 
lowercase letters are converted to uppercase. 

Permanent File 

A file that is created and stored by the user so that it 
can be accessed at some time in the future or by 
another user, or so that it can be used more than once 
in a specific terminal session. 

Pointer 

A position indicator; it identifies the line at which 
XEDIT will start processing a command. 

Prefix Character 

A special character that precedes an XEDIT 
command. The possible characters are /, f, X, +, or a 
line number. 



Primary File 

Any temporary file created with the OLD. LIBRARY, 
PRIMARY, or NEW command. There can be only one 
primary file at a time among the user's local files, but 
the user can change the primary file during a terminal 
session. 

Sequential File 

A file in which records are accessed in the logical 
order in which they occur. Any file can be accessed 
sequentially. Sequential files" must be accessed 
sequentially because no key or address is associated 
with each record in the files. 

Source Program 

A program written in a high-level language such as 
BASIC or FORTRAN. 

String 

A set of characters bounded on each end bv a nonblank 
character (called a delimiter). 

Suffix Character 

A special character which follows an XEDIT 
command. The possible characters are A (anchor 
suffix) and W (window suffix). 

Temporary File 

A file associated with a job that is not a permanent 
file. Temporary files no longer exist when the user 
logs off the system or returns the files to the system. 

Time-Sharing Subsystem 

Mode of communication for a time-sharing user. The 
subsystems available are: BASIC, BATCH, EXECUTE 
FORTRAN, FTNTS, and NULL. 

Toggle 

To switch from one mode to another. 

Verify Mode 

After a command is executed XEDIT prints the 
results. If the user entered the CHANGE command, 
XEDIT would print the lines that it changed. 



Window 



A specified range of columns, 
with the WMARGIN command. 



A window is defined 



Write Mode 



Allows a user to write, modify, append, read, execute, 
or purge the file (modify permission applies only to 
direct access files). 
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MESSAGES 



B 



This appendix contains an alphabetical listing of the 
messages that may appear in a user's output file. 
Lowercase characters are used to identify variable names 
or fields. All messages beginning with variable names or 
characters follow those beginning with A through Z and 
through 9. These messages are then alphabetized according 
to the first nonvariable word or character. Messages 
beginning with any special characters {such as hyphens or 
asterisks) are alphabetized as if the special character were 
not present. For example, the message 



is listed after the messages beginning with A through Z and 
through 9 and is alphabetized with the messages whose 
first nonvariable word or character begins with S. 

Other terminal error messages not listed are issued by 
NOS. Refer to the Time-Sharing User's Reference Manual, 
IAF Reference Manual, or the NOS Version 1 Diagnostic 
Index for explanation. The Diagnostic Index contains a list 
of messages issued by NOS and the manuals which explain 
them. 



filename SAVED 



An on-line explanation of any of these messages can be 
obtained by entering the EXPLAIN command after the 
message is printed. Refer to the EXPLAIN command for 
further details. 
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Cd 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



ABORTED 



ARGUMENT ERROR 



BAD FILE NAME 



BAD TEXT LINE ENCOUNTERED 



BATCH ABORT-COMMAND ERROR 



XEDIT terminated its execution and recorded 
only those editing changes performed during 
the editing session which were written to 
files via FILE, COPY, or COPYD commands. 

One of the following. 

One string field is needed but is 
missing^ 

- Two string fields are needed but the 
second is missing. 

- While in INPUT mode the user entered a 
line count or string count parameter 
value other than zero on a command that 
might move the pointer, or used the 
up-arrow or slash (/) prefix 
characters on a command. 

- Margin specifications on WMARGIN command 
are in wrong order. 

- The Y or Z command list is missing. 
In OCTCHANGE an even number of digits 
was not specified for the octal number. 

User did not specify a required file name 
or specified one that contains bad 
characters, is more than seven characters 
in length, or is reserved by XEDIT. 

The last word of a nonempty record does not 
contain an end of line byte. XEDIT aborts. 



Command syntax or parameter error (other 
than DELIMITER) was encountered in batch 
mode. XEDIT aborts. 



STOP command has been 
executed. Recall XEDIT 
if more editing is to be 
done. 

Reenter last command 
with correct parameters. 



XEDIT 



XEDIT 



Reenter command with 
correct file name 
specified. 



Most often user has 
forgotten to issue i 
PACK command after 
leaving TEXT mode. 
PACK the file and 
recall XEDIT. 

Correct error and 
resubmit job. 



XEDIT 



XEDIT 



XEDIT 



CANNOT EDIT EXECUTE ONLY FILES 



COMMAND NOT VALID 



User attempted to edit a file which is 
accessed in execute only mode. 



User issued an invalid command under INPUT 
or CREATION mode as follows: 
- Under INPUT mode, user issued a command 
which always moves the pointer (for 



Ensure that file name 
specified is correct. 
If "so, access file in 
write mode. 

Enter a valid command 
such as REPLACE under 
INPUT mode or INPUT 
under CREATION mode. 



XEDIT 



XEDIT 



DO 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



ra 



example DELETE, COPYD, or FILE). 
Under CREATION mode, user issued a 
command which assumes the presence of an 
existing text line (for example, DELETE 
or INSERTB). 



COMMAND STACKING ERROR 



User attempted to recursively call an input 
source (for' example, a Y or Z command is 
used within another Y or Z command) . 



Enter legal command. 



XEDIT 



DELIMITER 



EDIT 



Warning message indicating that user 
omitted closing delimiter of a delimited 
string parameter. XEDIT executes the 
command by assuming that a string delimiter 
appears after the last nonblank character 
of the string. 

User has been returned to EDIT mode. 



Continue editing. 



Enter next editing 
command. 



XEDIT 



XEDIT 



EMPTY FILE/CREATION MODE ASSUMED 



END OF FILE 



END OF INPUT ENCOUNTERED-ABORTED 



User entered XEDIT without specifying a 
file to be edited, no primary file is 
present as default, or the file specified 
by name or by default is empty. XEDIT 
automatically enters CREATION mode. 

XEDIT read the end-of-inf ormatlon mark and 
terminates execution of the last command. 
The file pointer is positioned at the 
b eg inning-of- information. 

While in batch mode an end-of-record, 
end-of-file, or end-of-inf ormation mark was 
encountered on the input file. XEDIT 
aborts. 



Enter a command valid 
under CREATION mode. 



Enter next editing 
command. 



Enter an END or QUIT 
command as the last 
command in the input 
file. Resubmit job. 



XEDIT 



XEDIT 



XEDIT 



EOF— 



XEDIT read an end-of-flle mark. Execution 
of the command continues until normal 
termination. 



The end-of-file mark 
can be deleted with the 
DEOF command and the 
printing of the message 
can be turned off by 
the TEOF command. 



XEDIT 



EOR- 



XEDIT read an end-of-record mark. 
Execution of the command continues until 
normal termination. 



The end-of-record mark 
can be deleted with the 
DEOR command and the 
printing of the message 
can be turned off by the 



XEDIT 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



ERROR IN XEDIT ARGUMENTS 



FILE FUNCTION ILLEGAL 



FILE NAME CONFLICT 



FILE NOT XEDITABLE 



*FR* COMMAND STACKING ERROR 



ILLEGAL PARAMETER 



INPUT 



LINE NUMBER NOT FOUND, COMMAND NOT EXECUTED 



LINE NUMBER TOO LARGE 



User issued an XEDIT control statement with 
illegal options specified. 

User is working with direct access files, 
entered END, FILE, or QUIT command, and 
specified the LOCAL option or specified the 
COPY option for a file not attached in 
WRITE mode. 

User issued more than one XEDIT control 
statement parameter which specified the 
same file name. 

User specified a nonempty file which does 
not contain a legal line. It cannot be 
edited by XEDIT. 

XEDIT internal error. The FR XEDIT control 
statement option has not been processed. 

User specified one of the following. 

- An alphabetic DELIMIT command delimiter. 

- Extra data after the last parameter. 

- A parameter on a command that does not 
require a parameter. 

- An RMARGIN command less than 10 or 
greater than 160. 

- Tab stop values not in increasing order 
or not between 1 and 160. 

User has entered INPUT mode. 



The line number prefix specified a line 
number not in the file. XEDIT does not 
execute the command and positions the 
pointer at the next highest line number. 

A line number formed by the ALN, ALNS, or 
RLN commands exceeded 99999. 



TEOR command. 

Correct the XEDIT 
control statement. 

Change the mode Option 
on the command. 



Correct the XEDIT 
control statement and 
reenter it. 

None. 



Inform site analyst. 



Correct command and 
reenter. 



After the prompting 
question marks appear, 
enter lines to be 
inserted. 

None. 



Reenter the command 
specifying a smaller 
starting line number 
or a smaller increment. 



XEDIT 



XEDIT 



XEDIT 



XEDIT 



XEDIT 



XEDIT 



XEDIT 



XEDIT 



XEDIT 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



LOCAL FILE ERROR 
NO SUCH COMMAND 

NULL LINE-IN CREATION MODE 

STRING NOT FOUND 

TRUNCATION AT n 



XEDIT version 



XEDIT INTERNAL ERROR (ERD). NOTIFY 
CONSULTANT 

YOU DELETED THE ENTIRE FILE 



0-IN CREATION MODE 



filenam ALREADY PERMANENT 



filenam CANNOT BE ACCESSED 



filenam IS A LOCAL FILE 



filenam NOT FOUND 
NAME EDIT FILE? 



XEDIT internal error. 

User entered an illegal command or an 
improper separator after the command. 

User issued a PRINT command on an empty 
file. 

The specified string could not be found. 
The file pointer is not moved. 



A processed file line (the nth line in the 
file) exceeds the maximum line width. 
XEDIT truncates the line. 

XEDIT header line listing current version. 



An XEDIT internal error has occurred. 



XEDIT cannot locate a line at which to 
position the pointer; XEDIT aborts. 



User issued a WHERE command; however, 
no lines exist within the file. 

User specified S or SAVE option on an END, 
FILE, or QUIT command and the named file is 
already permanent. 

User requested a file which is not local, 
is an execute only or append only file, or 
is not available from the user's permanent 
file area. 

User specified the L or LOCAL option on an 
END, FILE, or QUIT command. The edited 
file is now a local file. 

User requested a file which could not be 
found in the user's permanent file area. 
XEDIT requests the name of a file to edit. 



Inform site analyst. 
Enter legal command. 



Enter a command valid 
under CREATION mode. 

Extend search for 
string or continue with 
next editing command. 

None. 



Enter first editing 
command. 

Inform site analyst. 



Recall XEDIT. CREATION 
mode is assumed until a 
line of text exists 
within the file. 

None. 



Enter the END, FILE, or 
QUIT command with an R 
or REPLACE option. 

Ensure that the file to 
be edited is local and 
can be written on. 



None. 



Enter correct name of 
the file to be edited. 
If file is permanent, 
enter ,P after the name. 



XEDIT 
XEDIT 

XEDIT 

XEDIT 

XEDIT 

XEDIT 
XEDIT 
XEDIT 

XEDIT 
XEDIT 

XEDIT 

XEDIT 
XEDIT 



MESSAGE 



SIGNIFICANCE 



ACTION 



ROUTINE 



fllenam REPLACED 



filenam REWRITTEN 



file nam SAVED 



User specified the R or REPLACE option on 
an END, FILE, or QUIT command. The edited 
file has replaced the permanent file of the 
same name in the user's permanent file area. 

An END, FILE, or QUIT command has been 
executed for a direct access file. The 
edited file has been copied back to the 
permanent file of the same name in the 
user's permanent file area. 

User specified the S or SAVE option on an 
END, FILE, or QUIT command. The edited 
file is now an indirect access permanent 
file. 



If file is to be 
created, enter ,C 
after the name. 

None. 



None. 



None. 



XEDIT 



XEDIT 



XEDIT 



DO 



EXAMPLES OF XEDIT USE 



Figures C-l through Oil are sample editing sessions which demonstrate a collection of similar XEDIT commands. 

Figures C-12 and C-13 are sample batch processing control statement records which use XEDIT to edit a permanent file 
and to create a file. 

old, savings 
HEADY. 
xedit© 
XEDIT 3. 1-00 _ 
?? help, print (D 
PRINT $ [P] 



Action-' Prints $ lines starting at the current pointer position. The 
pointer is left positioned at the last line printed. © 
7? h th® 
TOPNULL 



Action-: Same as the TOP command except that a blank line is inserted 
as the first line of the file. If the edit file has leading record 
marks before the first text line, this command can be used to position 
the pointer before those marks. (t) 
??© ^ 



© User calls XEDIT into execution. 

© User issues HELP command; wants information about PRINT command. 

© XEDIT prints information about the PRINT command. 

© User issues an abbreviated HELP command; wants information about the 
TOPNULL. command. 

© XEDIT prints information about TOPNULL. 

© XEDIT indicates user should enter another XEDIT command. 

Figure C-l. HELP Command 
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old , savings 

READY, 
xedit© 

XEDIT 3. 1.00 
?? print*© 

00100 PRINT TABOO) ."DAYDREAM SAVINGS PLAN" 
00 1 10 PRINT " 

00120 PRINT "DAYS", "DAILY AMOUNT" , "TOTAL SAVINGS" 

00 HIO LET D=.01 

00150 LET A = 0' 

00160 LET A = A+D 

00170 PRINT USING 00180,N,D,A 

00190 LET # D-2 + D ######*##•## #########.## 

00200 LET N=N+1 

00210 IF N<31 THEN 00160 

00220 END 

END OF FILE 



? print (£) 

? 1 ?70C6) INT TAB(10) '" DAYDREAM SAVINGS PLAN"© 



00170 PRINT USING 00180,N,D,A 

?? x200© 

?? next © 

00210 IF N<31 THEN 00150 

?? Tnext3 ® 

00130 LET N=1 

?? next -3 @ 

00100 P^IFT TABOO) /'DAYDREAM SAVINGS PLAN" 

?? locate/let. . .+/* (fft 

00160 LET A=A+D ^ 

00190 LET D=2+D 

00200 LET N=N+1 
SFD OF FILE 

?? locate/let/^{f| 
00130 LET N=1 
00140 LET D=.Q1 . 
00150 LET A=0 
?? Drint @ 
00150 LET A=0 
?'? bottom O) 
00220 END 

9? 



© 



© 

© 



user caiis XEDIl'. 

User issues PRINT command to list 
entire contents of the file (that is, * is 
entered as the n parameter). 

XEDIT lists entire file. 

User issues PRINT command; by 
default since no n parameter appears, 
XEDIT assumes only 1 line should be 
listed. 



© XEDIT prints the line indicated by the 
^ current pointer position. 



NOTE 



Since the first PRINT 
command reached an 
end-of-file, the pointer 
was repositioned to the 



© User enters a particular line number 
(170) to place pointer at that position. 
By default, verify mode is in effect. 

© User enters line number 200 but 
indicates that XEDIT should not verify 
the current pointer position (that is, an 
X prefixes the user entry). 

© User issues NEXT command to 
advance the pointer by one line; 
XEDIT verifies the pointer position. 

® User issues an up-arrow (1) prefix to 
reposition pointer to the beginning of 
the file and to NEXT command. 
Advances the pointer by three lines. 

© User issues NEXT command to move 
the pointer backwards by three lines. 

@ User issues LOCATE command to find 
the third line (from the current pointer 
position) containing the string LET. 

@ User issues LOCATE command to find 
all lines in the file containing a 
combination of two strings (LET and +). 

© User issues PRINT command; pointer 
is positioned at the beginning of the 
file. 

@ User issues BOTTOM command; 
pointer is now positioned at the last 
line in the file. 



Figure C-2. Pointer Movement Commands 
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"DATEDREAM SAVING PLAN" 



old, savings 
READY. 

xedit © 

XEDIT 3.1.00 
?? print* © 
00100 PRINT TABOO) 

PRINT- 
PRINT "DAYS", "DAILY AMOUNT 1 ' , "TOTAL SAVINGS" 

LET N=1 

LET D=.01 

LET A=0 

LET" A=A+D 

PRINT USING 00130, N,D, A 



00110 
00120 
00130 
OniUO 
00150 
00160 
00170 
00180 
00190 
00200 
00210 
00220 
END OF 



LET D=2+D 

LET N=N+1 

IF N<31 THEN 00160 

END 

FILE 



?? locate/tab/ © 

00100 PRINT TAB( 10) , "DATEDREAM SAVING PLAN" 

?? change/(10)/(130/© 

00100 PRINT TAB( 13), "DATEDREAM SAVING PLAN" 

?? chanee/</<=7 © 

00210 IF N<=31 THEN 00160 

?? Tc/let//* © 

00130 N=1 

00140 Ds.01 

00150 A=0 

00160 A=A+D 

00190 D=2+D 

00200 N=N+1 

EN^ OF FILE _ 

?? locate/n=/® 

00130 N=1 

?? add @ 

? - 75 © ^ 
00130 N=1.75Q2 
?? IQOmodify © • 

00100 PRINT TAB(13) 



® 



© 



00100 PRINT" TAB(13) 



"DATEDREAM SAVING PLAN"! 
y# "s #© 

"DAYDREAM SAVINGS PLAN" ( 



© User calls XEDIT to edit a file called 
SAVINGS. 

© User issues PRINT command to list 
entire file. 

© XEDIT lists the SAVINGS file. 

© User issues LOCATE command to 
move pointer to first line containing 
the string TAB; XEDIT verifies which 
line was located. 

© User issues CHANGE command to 
replace each reference to (10) with 
(13) in the first line containing a (10); 
XEDIT verifies how the change was 
made. 

© User issues CHANGE command to 
replace each reference to < with < = in 
the first line containing a < sign; 
XEDIT verifies how the change was 
made. 

©" User issues an abbreviated CHANGE 
command with an up-arrow (t) prefix 
to delete all references to LET with a 
blank (in other words, delete the LET 
references) throughout the entire file. 

© XEDIT indicates which lines were 
affected by the preceding CHANGE 
command. 

© User issues LOCATE command to find 
the first line containing an N=string; 
XEDIT places pointer to line 130. 

© User issues ADD command to attach 
information onto the end of the line 
designated by the current pointer 
position (that is, line 130). 

@ User specifies that .75 should be added 
to the end of line 130. 

@ XEDIT verifies the change which 
resulted because of the above ADD 
command. 

© User issues MODIFY command to alter 
line 100. 

@ XEDIT prints line 100. 

<£§) User issues MODIFY directives to 
indicate how line 100 should be altered. 

@ XEDIT verifies how line 100 was 
affected by the above MODIFY 
command. 



Figure C-3. String Editing Commands 
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HQR24-13 
SWP 19-250 



old ,deDart 

HEADY. 

xedit© 

XEDIT 3. 1.00 
?? Dr* in'*" * 
*DF D ARTMENT 4208* 
D"208 E927 EX100 KRAMER, SCOTT W 
D4208 E208 EX130 JOHNSON, JACK J.' „ r Iy 
D4208 E442 EX120 MILLER, PICK HQR44-140 

pSn°nir S p?? P EX125 SC ° TT ' FRMK R - MXJ97-220 

dND OF FILE 

?? locate/130 

DELIMITER 

D4208 E927 EX100 KRAMER, SCOTT W 

?? trim © 

?? tlocate/130 / 

DJ208 F208 EX 130 JOHNSON, JACK J 

?? wmarsin 7 10 (5) 

?? riw/208/© W 

D4 208 E208 EX130 JOHNSON, JACK J 

?? win 18 18© 

?? tla/scott/ © 

DR208 E698 EX125 SCOTT, FRANK R 



C2 



HQR24-130 



SWP19-250 



SWP19-250 



MXJ97-220 



n\ T7__ „„ — . 

v^ user oius AiUir to edit a file called 

DEPAkT. 

© User issues PRINT command to list 
entire file; XEDIT lists file. 

© User attempts to find executive 
number 130 but instead finds executive 
100 since his facility number 
HQR24-130 happened to also have the 
number 130 in it. 



© To correctly locate executive 130, the 

user issues a TRIM command to tell 
XEDIT to ignore the trailing spaces 
(blanks) to the right of all facility 
numbers such as HQR24-130. 



© 






The user intends to search for 
employee number 208, so the 
W MARGIN command is issued to 
restrict the search window to just the 
employee number field (columns 7 
through 10 inclusively). 

^r.ce the window has been defined, the 
user issues an abbreviated LOCATE 
command (the window W postfix) to 
specify that XEDIT should look at only 
the employee number field during the 
search. XEDIT responds by finding 
employee Jack Johnson number E208 
as requested, instead of the first line 
with D4208 in it. 

Next the user wants to find the first 
employee whose last name is Scott. 
Since the last name field begins in 
column 18, the user issues an 
abbreviated WMARGIN command to 
redefine the window to be just that 
column. 



® The user finally issues an abbreviated 
LOCATE command with the anchor 
postfix A. The up-arrow (f) prefix 
tells XEDIT to begin the search at the 
top of the file. XEDIT correctly finds 
Frank Scott instead of Scott Kramer. 



© 



-4. String Search Control Commands 
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:rMecfon d 



old, plan 
READY. _. 
xedit UJ 
XEDIT 3.1. 00 
?? oriRt*(2) 
TABLE ONEVoN 
TABLE TWO V^/ 
END OF FILE/-S 
?? deftab ; \*J _ 

?? tabs 20 30 _40 50 60 (5) 
?? listab (6) 

; TABS _ 20 w 30 40 

?? (7) 

INPUT v_/ 

; profit picture 



50 



60 



1q;2q;3q;4q; total 



sales revenue;48,578;51 ,027;53,593;56,300;$209 ,503 
total expenses;42,273;43,952;45,709;47,548;$179 ,482 
ooerating orofit;6 , 305 ;7 ,075; 7 ,889 ;8 ,752; $30 ,021 



EDIT W / ~ 5 . 
?? next OQ 
TABLE TWO 
?? tats 24 34 
?? listab ( 
; TABS_ 24 






44 



INPUT w 
? ;;oash flow forecast 
•j .................... 

? ; july;aug; sept 

9 ..Ww*.-— »-■• -w 

? total' cash available; 450 ,000; 452, 300; 459 ,316 
? total cash required; 378 , 100; 388, 600;397, 908 
? ending cash balance;71 ,900;63,700;61 ,408 



EDIT W 
?? "print* 
TABLE ONE 



SALES REVENUE 
TOTAL EXPENSES 
OPER«t<-mg PROFIT 

TABLE TWO 



PROFIT PICTURE 



1Q 

48,578 
42,273 
6,305 



2Q 

51,027 
43,952 
7,075 



3Q 

53,59 8 
45,709 
7,889 



4Q 

56,300 
47,548 
8,752 



TOTAL 



$209,503 
$179,482 
$30,021 



CASH FLOW FORECAST 



TOTAL CASH AVAILABLE 
TOTAL CASH REQUIRED 
ENDING CASH BALANCE 

END OF FILE 



JULY 

450,000 
378,100 
71 ,9 00 



AUG 

452,300 
388,600 
63,700 



SEPT 

459,316 
397,908 
61 ,408 



'© 



(T) User calls XEDIT to edit a file called 
PLAN. 

(D User issues a PRINT command to list 
entire file. 

© XEDIT lists file. 

(4) User issues DEFTAB command to 
establish a semicolon(;) as the tab 
character. 

(D User issues TABS command to 
establish tab stop column positions 20, 
30, 40, 50, and 60. 

(?) User issues LISTAB command to list 
the current tab character and tab stop 
column positions. 

(7) User presses carriage return to insert 
an unknown number of lines after the 
TABLE ONE line. 

(D User enters several new lines with the 
- tab character used where tabbing is 
desired. 

(i) User presses carriage return to 
terminate the insertion of new lines. 

@ User issues NEXT command to 
advance the pointer by one line; 
XEDIT verifies the pointer position. 

@ User issues another TABS command to 
reset the tab stops to positions 24, 34, 
and 44. 

@ User issues LISTAB command to list 
the current tab character and tab stop 
column positions. 

(y) User presses carriage return to insert 
an unknown number of lines after 
TABLE TWO line. 

@ User adds several new lines with the 
tab character used where tabbing is 
desired. 



Qj) User presses carriage return to 
terminate the insertion of new lines. 

@ User issues a PRINT command with an 
up-arrow (t) prefix to list the entire 
file. 

@ XEDIT lists the file verifying that 
tabbing was correctly performed. 



Figure C-5. Tab Control Commands 
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old , manager 
HEADY, 
xedit © 

XEDIT 3. 1.00 
?? orint* (2) 
"EXECUTIVE MANAGEMENT* 



2X100 S.W. 

Exno j.j. 

EX12H o >E 
EX125 F.R. 
END OF FILE 

rmsrgin 30 © 



KRAMER 
JOHNSON 
MILLER 
SCOTT 



?? 



findll* 
cy mo s.w. 
crv ll n J.J. 
EX120 R.E. 
END OF FILE 
?? trunc* 
♦EXECUTIVE 
EX100 S.W. 
EX1 10 J.J. 
EX120 R.E. 
5X125 F.R. 
END OF FILE 



KRAMER 
JOHNSON 

MILLER 



HQR2*J-'130 
SWP19--130 
HQRim--l30 
MXJ9 7 



BQR24-130 
SWP19-'130 
HOR44-130 



MANAGEMENT* 

KRAMER HQR2 4-'13 



JOHNSON 

MILLER 

SCOTT 



SWP19-'T3 
HOR44-'13 
MXJ9 7 



© 



yj User calls XEDIT to edit a flip m n«i w iv.^r D 

® User issues PRINT command to list entire file. 

® XEDIT lists file. 

© User sets the right margin to column 30. 

® t U h S n n ^ U l StS XEDIT ;° find all lines that are larger 
tnan 30 characters (current RMARGIN setting) bv 

Sd g ingl h y e . FINDLL C ° mmand; XEDIT ™ 

® t U h S f S qU ? tS XEDI 7 t0 truncate & "'nes larger 
than 30 characters (current RMARGIN setting) bv 

SSSmS! TRUNC mmmi; XEDIT ~ 



© 
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Figure C-6. Margin Control Commands 
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old ,add5 

READY. 

xedit ® 
XEDIT 3. 1.00 

?? orint* @ 

### NAMES/ADDRESSES 
00100 M.T. JONES 
00110 1544 WILSHIRE 
00120 SX6533 
00160 Q.E. SMITH 
00165 APT 23 
00170 POB 55 ZIP 99 107 
00180 EXT 8837 
0019 P.T. BEE 
00200 8710 14TH ST 
00210 EXT 18 
END OF FILE 
?? 190delete3 © 
C0 19 P.T. BEE } 
00200 8710 14TH ST [ © 
00210 EXT 18 j 
END OF FILE 
?? locate/Dob© 
DELIMITER 

00170 POB 55 ZIP 99 107 
?? replace© 
° ^0170 138 chess ave ® 
?? insertb © 
? 00166 c/0 b.t. smith sr 
?? bottom @ 
00180 EXT 8837 
?? u2) 

INPUT 

? 00190 

? 00200 

? 00210 



ARE FICTITIOUS ##/A 



ST ZIP 55722 



© 



© User calls XEDIT to edit a file called ADD5. 

© User issues PRINT command to list the entire file. 

® XEDIT lists ADD5 file. 

® User issues a DELETE command with a 190 prefix to 
specify that he wants to position pointer to line 190 
and wants to delete the next three file lines starting 
at line 190. 

© XEDIT verifies which three lines were deleted. 

© User issues LOCATE command to find first line 
containing the string POB; XEDIT indicates line 170 
is found in response. 

© User issues REPLACE command to insert an entirely 
new line of information in place of line 170. 

© User indicates what new information should replace 
line 170. 

© User issues INSERTB command to enter an entire 
line of information in front of the current pointer 
position (that is, in front of line 170). 



© 

(£j) User issues BOTTOM command 



t.r. 

662 

ext 



doesinger 
elm st 
7714 



EDIT 
?? Unsert© 

? #sample line editing command session#( 
?? Tprint* © 

### NAMES/ADDRESSES AE FICTITIOUS ###} 
# SAMPLE LINE EDITING COMMAND SESSION* 
00100 M.T". JONES 

00110 1544 WILSHIRE ST" ZIP 55722 
C0120 EX6533 
00160 Q.E . SMITH 
0016* «PT 23 
00166 C/n B.T". SMITH SR 
00170 138 CHESS AVE 
00180 EXT 8837 
0019 T.R. DOESINGER 
00200 662 ELM ST 
00210 EXT 7714 
END OF FILE 

99 






User enters the new information that should be 
placed in the line which will precede line 170. 



User presses carriage return to insert an unknown 
number of lines after line 180. 

User enters three new lines. 

User presses carriage return to terminate the 
insertion of new lines. 

User issues INSERT command with an up-arrow (f) 
prefix character to enter one new line after the first 
line in the file (the pointer is positioned to the first 
line in the file). 

User enters the new line. 

User enters a PRINT command with an up-arrow (f) 
prefix character to list the file in its edited form. 



L8) XEDIT lists the edited file. 



Figure C-7. Line Editing Commands 
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ARE FICTITIOUS ### 



old,add5 

READY. 

xedit© 
XEDIT 3. 1.00 

?? print*© 

### NAMES/ADDRESSES 

00100 M.T. JONES 

00110 1544 WILSHIRE ST ZIP 55722 

00120 EX6533 

00160 Q.E . SMITH 

r,r "\f>5 APT 23 

00170 POP 55 ZIP 99 107 

00180 EXT 8817 

0019 P.T'. BEE 

00200 8710 14TH ST 

00210 EXT 18 

END OF FILE 

?? brief® 

?? change/zip/ziD code/*© 

END OF FILE 

?? change/ext/extension/*© 
END OF FILE 

?? print* © 

### NAMES/ADDRESSES 

00100 M.T. JONES 

00 110 1544 WILSHIRE ST ZIP CODE 55722 

00120 EX6533 

00160 O.E. SMITH 

00165 APT 23 

C0170 POB 55 ZIP CODE 99107 

00 180 EXTENSION 8837 

0019^ ".r. BEE 

00200 8710 14TH ST 

00210 EXTENSION 18 

END OF FILE 

?? verify © 

T? change/zip code/ziD/* 

omir, -,5^4 WILSHIRE ST ZIp 55 7 2 2 

00170 POB 55 ZIP 99 107 (n) 

END OF FILE ^ 

?? change/extension/ext/* @ 
00180 EXT 88^7 ~ 
uuiiu aXi 1 o ^e* 
END OF FILE 



© 



AE FICTITIOUS ### 



^y wov-. ^cixxo Aiiuu iu euii a me caned ADD5. 

© User issues PRINT command to list the entire file. 

® XEDIT lists file. 

© User issues BRIEF command so that XEDIT will not 
verify the effects of XEDIT commands. 

© User issues CHANGE command; XEDIT does not 
verify its results. 

© User issues another CHANGE command; XEDIT does 
not verify its results. 

© User issues PRINT command. 

© XEDIT lists edited file; indicates how the above 
commands altered the user's file. 

© User issues , VERIFY command so that XEDIT will 
verify the effects of XEDIT commands. 

© User issues CHANGE command. 

<fl) XEDIT VPrifioc u;hJ«h Kr,„o ... .«._,.. j , 

_ -- * — ....^.. iil<w « C1C tuiecieu dv me 

preceding CHANGE command. 
© @ User issues another CHANGE command. 



XEDIT verifies which lines were affected by the 
preceding CHANGE command. 



Figure C-8. VERIFY and BRIEF Commands 
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old , address 

READY. 
xeditQ 

XEDIT 3.1.00 

?? print*© 

### NAMES/ADDRESSES ARE FICTITIOUS ### 

00100 M.T. JONES 

00110 1544 WILSHIRE ST ZIP 55722 

00120 EXT 6533 

00160 O.E. SMITH 

00165 APT 23 

00170 POB 55 ZIP 99107 

00180 EXT 8837 

00190 P.T. BEE 

00200 8710 14TH ST 

00210 EXT 1831 

END OF FILE 

?? xchange/zip/zip code/*® 

END OF FILE 

?? file.newf ,s(D 

NEWF SAVED© 

?? xchange/ext/extension/*® 

END OF FTLE 

?? file, /replace® 

ADDRESS REPLACED® 



® 



® User calls XEDIT to edit ADDRESS file. 

® User issues PRINT command to list entire file. 

® XEDIT lists file. 

® User issues CHANGE command prefixed by an X; 
since verify mode is automatically in effect, the X 
prefix suppresses command verification. 

® User issues FILE command to save the editing 
changes on a new permanent file called NEWF. 

® XEDIT indicates that NEWF has been saved in the 
user's permanent file catalog. 

® User issues another CHANGE command with X 
prefix. 

® User issues another FILE command to save these 
editing changes; since the REPLACE option is 
selected and the fname parameter defaults to the 
primary local file, the change from- both CHANGE 
commands now appear on the- permanent copy of 
ADDRESS. 

® XEDIT indicates that the edited file has replaced 
the original file in the user's permanent file catalog. 



Figure C-9. FILE Command 
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old , address 

READY. 
xeditQ 

XEDIT 3. 1.00 
?? print*© 
### NAMES/ADDRESSES 
00100 M.T. JONES 

1544 WILSHIRE 
EXT 6533 






TT _- 



uacr caus Atuu to edit ADDRESS file. 



00110 
00120 
00160 
00170 
00180 
00190 
00200 
00210 



ARE FICTITIOUS ### 
ST 



O.E. 

P0B 

EXT 

P.T. 

8710 



SMITH 
55 
8837 

BEE 

14TH ST 



EXT 18 
END OF FILE 

?? z$l/ext/$n-1$+add$55722$xn2(4) 
?? L/EXT/ \ 

00120 EXT 6533 L~v 
?? N-1 ((§) 

001 10 1544 WILSHIRE ST* 
?? +ADD 

00110 1544 WILSHIRE ST55722(6) 
?? XN2© w 

??-<§) 
?? L/EXT/ 
00180 EXT 8837 
?? N-1 

00170 POB 55 ,(§) 
?? +ADD 

00170 POB 5555722 
?? XN2 
?? -© 
?? L/EXT/ 
00210 EXT 18 
?? N-1 

00200 8710 14TH ST 
?? +ADD 

00200 8710 .14TH ST55722 
?? XN2 
END OF FILE 

?? y$l/ext/$n-1$modify$xnext2(|2) 

00120 EXT 6533 

00110 1544 WILSHIRE ST55722 )^ 

00110 1544 WILSHIRE ST55722/® 
? f zip #(g) 

00110 1544 WILSHIRE ST ZIP 55722^ 
?? -<§) ^ 

00180 EXT 8837 
00170 POB 5555722 ) 

00170 POB 5555722 © 
? t zip # J 

00170 POB 55 ZIP 55722 

?? -d§) 

00210 EXT 18 

00200 8710 14TK ST55722 \ 
00200 8710 14TH ST5572; 

? f zip # I 

00200 8710 14TH ST ZIP 55722 
END OF FILE 

O 9 



(U) 



© User issues PRINT command to list entire file. 
© XEDIT lists file. 

© User issues a Z command which contains 4 
component commands; its objective is to add a 
numeric zip code to the file line containing an 
address. In this Z command, a $ acts as the 
delimiter which separates component commands. In 
addition, the plus (+) prefix on the ADD command 
tells XEDIT that ADD input data (in this case a zip 
code) wiU come from the next entry on the Z 
command sequence, rather than from normal input 
mode [a single question mark (?)]. 

© XEDIT verifies that the first three component 
commands (LOCATE, NEXT, and ADD) are executed. 

© XEDIT verifies how the ADD command affected the 
file. 

© XEDIT verifies the 4th comDonent command (NEXT) 
is executed. 

© User enters a - sign to advance the file pointer (one 
line by default) and reexecute the preceding Z 
command; user wants to modify the second address 
in the file. 

® XEDIT reexecutes the Z command sequence. 
© 

© 



User enters a - sign 
reexecute Z command; 
third address in the file. 



to advance pointer and 
user wants to modify the 



XEDIT reexecutes the Z command sequence. 

@ User enters a Y command which is made up of 4 
component commands; its objective is to add the 
word ZIP before each numeric zip code in the file. 
Unlike the Z command, the Y command does not list 
each component command before it is executed. 

B> XEDIT executes the MODIFY command (which is 
one of the component Y commands). 



© Since the plus (+) 
MODIFY command 



® 



prefix was not used on the 
the user issues his MODIFY 

directives from normal input mode fa single question 

mark (?)] to alter line 110. 

© XEDIT verifies how these directives affected line 

0> User enters - sign to reexecute the preceding Y 
command after, advancing the pointer one line; user 
wants to modify the second address in the file. 

Q XEDIT reexecutes the Y sequences; user modifies 
the second address. 

g) User enters - sign to reexecute Y command and 
modify the third address in the file. 

LJ) XEDIT reexecutes the Y sequence; user modifies the 
third address. 



Figure C-10. Y and Z Commands and + Prefix Character 



-10 



sn.di^'nn o 



old , address 
RFADY. 

hr-it-.-; 1 - 
ftRFt.,0. 

/xedit© 

XEDIT 3.1.00 
?? print*® 

### NAMES/ADDRESSES ARE FICTITIOUS ### 
00100 M.T. JONES 
001 10 1544 WILSHIRE ST 
00120 EXT 6533 
00160 Q.E. SMITH 
00170 POB 55 
00180 EXT 8837 
00190 P.T'. BEE 
00200 8710 14TH ST 
00210 EXT 18 
END OF FILE 
?? change/***/***/ (£> 

*** NAMES/ADDRESSES ARE FICTITIOUS *** 
?? end,,r © 
ADDRESS REPLACED (7) 
/lnh ® 

### NAMES/ADDRESSES ARE FICTITIOUS ###' 
00 100 M.T. JONES 
00110 1544 WILSHIRE ST 
00120 EXT 6533 
00160 Q.E. SMITH 
00170 POB 55 
00180 EXT 8837 
00190 P.T. BEE 
00200 8710 14TH ST 
00210 EXT 18 
/old ,address© 
/lnh © 

*** NAMES/ADDRESSES ARE FICTITIOUS *** 
00 100 M.T. JONES 
00110 1544 WILSHIRE ST" 
'00120 EXT 6533' — 

00160 O.E. 'INTERRUPTED* Qj) 
stop 

•TERMINATED* 
/xedit© 

XEDIT 3.1.00 
?? print© 

*** NAMES/ADDRESSES ARE FICTITIOUS *** 
?? change/***/***/® 

#** NAMES/ADDRESSES ARE FICTITIOUS ##* 
?? end, ,rl @ 
ADDRESS REPLACED© 
ADDRESS IS A LOCAL FILE 
/lnh © 

*** NAMES/ADDRESSES ARE FICTITIOUS #** 
00100 M.T. JONES ^ 

00110 1544 WsILSHI TERMINATED* Qj) 
old , address © 
/lnh © 

*#* NAMES/ADDRESSES ARE FICTITIOUS **# 
00 100 M.T. JONES ^ 

00110 1544 WILSHI 'INTERRUPTED* %& 
stop 

'TERMINATED* 



© 



© 



© User calls XEDIT to edit ADDRESS file. 

© User issues PRINT command to list entire file. 

© XEDIT lists file. 

© User issues CHANGE command to replace each 
instance of ### with ***. 

XEDIT verifies which line(s) is affected by preceding 
command. 

© User issues END command to terminate XEDIT 
execution and replace the original ADDRESS file 
with its edited version. - 

© XEDIT indicates that the edited file now resides in 
the user's permanent file catalog. 

© User issues LNH command to list contents of the 
current primary local file. 

© NOS lists primary local file; listing indicates that 
the local file does not contain the XEDIT editing 
changes. This situation occurs as a result of the 
user's selection of REPLACE as the mode : parameter 
in the preceding END command. 

© User accesses the permanent file version of 
ADDRESS. 

© User issues LNH command to check its contents. 

© NOS listing indicates that the permanent file version 
of ADDRESS does contain the above XEDIT editing 
changes. 

© User presses break key to terminate listing. 

© User calls XEDIT to edit the current primary file 
(that is, the permanent file version of ADDRESS). 

© User issues PRINT command to list the first line in 
the file; XEDIT prints that line. 



© 
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User issues CHANGE command. 

User enters END command to terminate XEDIT 
execution; specifies RL option as a mode parameter 
so that the edited file will replace the existing 
permanent file in the user's catalog and 
simultaneously also appear as the new primary local 
file. 

XEDIT indicates that the edited file has replaced 
the older permanent file and also appears as the 
primary local file. 

User issues LNH command to list contents of 
current primary local file. 

NOS lists the local file; listing indicates the editing 
changes appear on the local file. 

© User terminates listing by pressing S key. 

© User accesses the current version of ADDRESS 
permanent file. 

© User issues LNH command to check the permanent 
file's contents. 

© NOS lists the permanent file; listing indicates that 
the edited file replaced the original file. 

© User presses break key to terminate listing. 

Figure C-ll. Terminating XEDIT Function 
& C-ll 



© 






^^XT^T^*^™.!!^* * »« ^^ <" th. second record of «,. i0 o 

^u.^p.uneuui, luc vjcun-ai sice line Drinrer. 



_., .... . . ,-- All 

i-ai sice une printer. 



NEWPLAN. 

USER(usrname , Dasswrd , family) 

CHARGE ( chrgnurn , pro inum) 

XEDIT(pl an ;L=out,C) 

REWIMD(out) 

COPYSBF(out) 

7/8/9 

deftab* 

tabs 20 30 40 SO 60 

input , * 

**profit picture 

*1a*2a*?a*u a *total 
* * * * * 



sales revenue*^, S78*51, 027*53, 598*56, ?00*$209 SO? 
total expenses*42, 273*43, 9 52*45, 709*475 48*$ 179 '482 
operating profit* 6,305* 7,075* 7,889* 8,752*$ 30 025 
' ed i t 



too 

print* 
end , , rl 
6/7/8/9 



The following is the output from the batch job NEWPLAN. 



XEDIT 3.1.00 

INPUT 

edit 



PROFIT PICTURE 
1Q 2Q "~3Q~" 4Q TPTAL 



SALES RFVFMUE «fl S78 R1 n?7 ZZ cno ZZ -, « 

TOTAL FXPENSFS 4? 27? aJ'«3 ' ? 6 ' 3 ° fi *209,503 

----- 'iifji <?#? -?:5SS 'Z : $ rn.-ssi 



PLAM REPLACFP 

PL AM IS A LOCAL FILE 



Figure C-12. Calling XEDIT Within a Batch Job to Create a File 



C-12 



rm.. w,.*~k ~w wvoi am »oiic rvT\rv <-n oHit a n^mflnent file called Dlan. All XEDIT output goes on a file called out which is 

me uaccn jwu i-j- - ■- - — ■- - 



rewound and printed on the central site line printer. 



"'F'fusrnane.nasswr^fanilv) 
rflA°CK(cbr(?nun,proinun) 

T"TVT>{out) - 



The following is a listing of the file OUT, 

6,305 



XEDIT 3.1-00 
OPERATING PROFIT 



10 



^ALFS RFVFMUF 4g,S78 
TOTAL EXPENSES 42,27? 
OPFPATING PROFIT 6,305 

EMD OF FILF 

PLAN REPLACED 

PI am IS A LOCAL FILF 



7,075 7,*aq 

PROFIT PICTURE 



2Q 

51 ,027 

42,052 

7,075 



30 

53,598 

4S.709 

7,*89 



8,752 



40 

56,300 

47,548 

8,752 



% 30,021 



TOTAL 



$209, 503 
*179,482 
$ 30,021 



Figure C-13. Calling XEDIT Within a Batch Job to Edit a File 
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INDEX 



A suffix 5-5 
Accessing files 2-1 
ADD command 5-1 
Adding line numbers 7-1 
Adding to a line 5-1 ,3 
ADDLN command 7-1 
ADDLNS command 7-2 
Advancing pointer 4-1,3 
Alignment guide 5-6 
Appending a string 5-1 
ASCH files 1-1 
ASCII mode 2-1 



B parameter 2 L 3 

Bad lines 7-3 

Batch usage of XEDIT 2-3,4 

Input mode 6-4 
Bell ringing 3-3 
Binary files 1-1 
Blanks 5-4 

BOTTOM command 4-3 
BREAK key 3-3 
BRIEF command 3-2 
Brief mode 3-2,3 



DEFTAB command 11-1 
DELETE command 6-1,2 
DELETELN command 7-2 
Deleting 

Characters 5-6,7 

File marks 8-3 

Leading blanks 8-1 

Lines 6-1,2 

Line numbers 7-2 

Lines without line numbers 7-4 

Record marks 8-3 

Strings 5-2 
DELIMIT command 10-1 
Delimited command sequence 10-1 

Interrupting execution of 3-3 

On control statement 2-1,2 
Delimiter character for 

dcs parameter 2-2 

Delimited command sequence 10-1 

String parameter 3-2 
DEOF command 8-4 
DEOR command 8-3 
Direct access file editing 2-1; 9-3; 12-2 
Display code conversion 8-2 
DLBLANKS command 8-1 
Dropping lines 6-1,2 



C parameter 2-2 

Caning XEDIT 2-1 

Cancellation of editing changes 8-2 

Carriage return 

Speed adjustment 2-1; 5-6 

To enter and leave input mode 6-4 
CHANGE command 5-1,2,3 
CHANGES command 5-1,2,3 
Changing strings character by character 5-6 
Character-by-character line modification 5-6 
Command 

Descriptions 3-4 

Parameters 3-1 

Prompts 3-1,2 

Repetition 10-2 

Syntax 3-1 
Conversion of octal strings 8-2 
COPY 

Command 9-1 

Mode parameter 

On END or QUIT commands 12-2 
On FILE command 9-3 
COPYD command 9-2 
^Qrnriricr gclit linss to snothsr flls 9—1 
Copying files 9-2 
Creation mode 2-2 



DBADL command 7-4 

Dcs parameter 2-2 

Default conditions 3-2 

Defining a 

Delimiter character 10-1 
Escape character 6-5 
Tab character 11-1 
Window 5-4 



EDIT.command 6-4,5 

Editing lines 6-1 

Editing line numbers 7-1 

Editing strings 5-1 

END command 12-1 

End-of-information 4-1 

Entering editing data 3-2 

Entering more than one command 10-1 

EOF message 3-3 

EOR message 3-3 

Error message explanation 3-4 

Escape character 6-4,5 

EXPLAIN command 3-4 



FBADL command 7-3 
FILE command 9-3 
File 

Copying 9-1 

Line length 5-1,7; 7-1; 11-2 

Manipulation 9-1 

Marks 1-1; 3-3; 8-3; 9-2 

Pointer in input mode 6-4 

Pointer movement by prefix or command 4-1 

Saving 9-2 

Types 1-1 
Finding lines without line numbers 7-3 
FIN DLL command 11-2 
First record editing directives 2-3 
Format of commands 3-1 
FR parameter 2-2 



HELP command 3-4 
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I parameter 2-3 
Initiating X EDIT 2-1 
INPUT command 6-4 5 
Input file 2-3 
Input mode 6-4,5 
INSERT command 6-3 
INSERTB command 6-4 
Inserting 

Blank line at top of file 

Characters 5-6,7 

File marks 8-5 

Lines 6-3,4,5 

Nonprinting characters 

Record marks 8-4 

Strings 5-1,3 
Interactive usage of XEDIT 
Interrupting XEDIT 3-3 



8-1 



8-2 



2-3 



Octal string conversion 8-2 
OCTCHANGE command 8-2 
Output file 2-3,4 



P parameter 2-3 
Permanent file editing 2-1,2 
Prefix characters 3-1 

t , / 4-1 

+ 10-1 
Pointer 4-1 

Primary file editing 2-1 
PRINT command 4-4 
Printing lines 4-4 
Prompts 3-2 



L command parameter 2-3 
Limiting the string search 5-4,5 
Line 

Count 4-4 

Deletion 6-1,2 

Editing 6-1 

Insertion 6-3 

Listino - 4.-4 

Replacement 6-2 
Line number 4-1 

Command 4-1 

Deleting line without 7-4 

Deletion 7-2 

Insertion 7-1 

Prefix 3-1 

Replacement 7-2 

Search for line without 7-3 
LISTAB command 11-1 
Listing lines 4-4 
Listing tab settings 11-1 
LN parameter 3-1 . 
Local file editing 2-1 
LOCAL mode parameter 

On FILE 9-3 

On END or QUIT 12-2 
LOCATE command 4-1,2,3 
Locating lines 4-1 
Locating strings 4-2 
Login procedure 2-1,3 
Long lines 11-2 



QMOD command 5-7 
QUIT command 12-1 



READ command 9-2 
READP command 9-2 
Record mark 1-1 

Deletion 8-3 

Insertion 8-4 

Suppression 3-3 
Repeating commands 10-2 
REPLACE 

Command 6-2 

Mode parameter 

On END or QUIT command 12-2 
On FILE command 9-3 
Replacing 

Characters 5-6,7 

Line numbers 7-2 

Lines 6-2 

Strings 5-1 
REPLACELN command 7-3 
RESTORE command 8-2 
Restricting field of search 5-4 
Reverse pointer movement 4-3 
RL mode parameter 

On END or QUIT commands 12-2 

On FILE command 9-3 
RMARGIN command 11-2 



M parameter 3-1 
Margin setting 5-4; 11-1,2 
Merging files 9-2 
Missing characters 2-1 
Mode parameters 

On FILE command 9-3 

On END or QUIT commands 12-1,2 
Modification directives 5-6 
MODIFY command 5-7 
Modify lines 5-1,2,6,7 
Modifying character by character 5-6 
Moving pointer 4-1,3" 
Multiple command entries 10-1 

N parameter 3-i 
NEXT command 4-3 
NH parameter 2-4 
NOBELLS command 3-3 
Nonprinting characters 8-2 
Normal mode 1-1 



SAVE mode parameter 

On END or QUIT commands 

On FILE command 9-3 
Saving XEDIT file 9-2; 12-1 
Setting 

Right margin 11-2 

Tab stops ll-l 
SL mode parameter 

On END or QUIT commands 

On FILE command 9-3 
String 

Appending 5-1 

Deletion 5-2 

Delimiters 3-2 

Insertion 5-1 

Replacement 5-1 

Search restrictions 5-4,5 
STOP command 12-1 
Subsystems 2-1 
Suffix characters 5-5 



12-2 



12-2 



Index-2 



Tab character 

Definition 11-1 

In input mode 6-5 
Tab stop setting 11-1 
TABS command 11-1 
TEOF command 3-3 
TEOR command 3-3 
Terminal bell suppression 3-3 
Terminating X EDIT 12-1 
Time-sharing origin editing 2-1 
TOP command 4-3 
TOPNULL command 8-2 
Trailing blanks 5-4 
TRIM command -5-4 
TRUNCATE command 11-3 



WMARGIN command 5-4 



X prefix 3-1,3 




XEDIT 




Call 2-1 




Command format 2 


Input 2-2 




Interruption 


3-3 


Output 2-3 




Parameters 


2-1,2,3 


Termination 


12-1 



VERIFY command 
Verify mode 3-2 



3-2 



Y command 10-1,2 
YQMOD command 5-7 



Z command 10-1,2 



W suffix 5-5 
W EO F command 8-5 
WEOR command 8-4 
WHERE command 4-4 
Window restriction 5-4,5 



- command 
. command 



10-2 
10-2 
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